Advanced Zone Manager

Features

• Create zones with unique settings, such as name, color, visibility, etc.
• Add entry and exit messages with a high degree of customization.
• Create advanced and intuitive configurations for zones to use, allowing you to restrict tools and weapons as well as allowing you additional options, such as preventing entering or leaving the zone, etc.
• See screenshots for more intuitive explanations!
• Heavily optimized for minimum performance impact on server CPU time. (basically, lots of zones shouldn't cause a big drop in performance).
• Configure Zone tickrates or enable player only zones to help improve performance.
• Extensive restrictions list for weapons, tools and more.
• Group specific modifiers/restrictions. Want only admins to be able to enter a zone? No problem.
• Supports (in theory) any gamemode with teams. It has been designed with DarkRP in mind, but it should support other modes, such as TTT, sandbox, etc.

Modifiers

You are able to configure what 'modifiers' the zones will put on each player that enters them. Each modifier can be applied to specific usergroups or teams of players on the server (such as affect all VIPs or only affect police) Here's a list of possible modifiers:

• Health Multiplier - Multiply the health of players who enter the zone.
• Max Health Multiplier - Multiply the max health of players who enter the zone.
• Health Drain - Drain a certain amount of hp per second of players who enter the zone.
• Healing - Restore health to players who enter the zone.
• Speed Multiplier - Make players entering faster or slower.
• Gravity Multiplier - Change the gravity of players in the zone.
• Jump Height Multiplier - Change the jump height of players entering the zone.
• Damage Multiplier - Change the damage players deal while in the zone.
• Damage Taken Multiplier - Change the damage players receive while in the zone.
• Teleport - Teleport players who enter this zone to another.

Requirements

You need to have my two modules installed in order for the zone menus to work. They're completely free and you're allowed to use them in whatever way you want. They require no additional set up.

https://github.com/Fortune117/discreteui

https://github.com/Fortune117/discretemessages

Known Issues

• This system is very complex. It's not unlikely for things to go wrong at somepoint when setting up the zones. If you encounter any errors, please feel free to submit a report.
• Most errors are likely to be fixed by simply rejoining/restarting the server or restarting your game.

Requirements

You will need to install discreteui and discretemessages for the zone system to work properly. DiscreteUI is a free UI framework developed by me that is used by this addon.

Discrete Messages is another free framework used for sending messages to the client, like the big popup messages for entering zones.

discreteui - https://github.com/Fortune117/discreteui

discretemessages - https://github.com/Fortune117/discretemessages

Just drag all three addons into the addons folder and you should be good to go.

Configuration

Once the addon is installed, most configuration should be done. However, if your server has custom usergroups (such as VIP, Moderator, etc) then you will need to add them into the config files.

Under lua/discretezones/config.lua you can edit the list of usergroups that will appear as options when configuring zones, as well as a few other niche settings.

sh_zonesettings.lua is also a config file, but is mostly aimed at developers. Unless you know what you're doing, changes in this file may break things.

Under server/sv_config.lua you can edit the roles that are able to actually create zones. This is important, as it is only for superadmins by default. If you wish to allow other roles to create zones, then add them in there.

Creating Zones & Configs

You can create zones (if you're the appropriate group - see installation) using the tool Zone Manager under Discrete Tools. There are instructions for using the tool on the tool itself.

You can additionally press the reload key to bring up the Zone Manger menu. In here you will be able to modify the settings of any zones on the map, and if pressed while looking at a zone, you can edit that zones settings in particular.

If you press the reload key while holding use, you will open the Zone Config Manager. Here you can create configs that can be assigned to zones.

If you wish to use zones on a non-sandbox based gamemode, that's fine, but you'll need to do some extra steps. First, run the map you wish to add zones to on sandbox and then add zones as normal. You wont be able to customize zones for teams in that gamemode (atm anyway, I'll probably fix this later), then once you're done quit the map or restart your server and you're done.

There is a lot of things you can add or change about the way the zones system works. All of the settings are configurable under sh_zonesettings.lua.

Adding settings should be fairly straightforward, simply add them to the appropriate table in sh_zonesettings.lua and then implement the effects in the sv_modifiers.lua file. It should be fairly straightforward, just follow the examples in the lua file.

You can also create different zone 'types'. Zone are treated as object oriented, and as a result, you can create custom zone types that can be used for all number of purposes. They have functions for detecting when things enter/leave/take damage/etc. For a list of all the functions of the zones, look at the _base.lua file under lua/discretezones/zones.