Bukkit

AcControl - the Factions-aware air space control for AutoCraft

I like Autocraft and I like Factions. But I wanted the airships not to fly over foreign factions territory - it would have made raiding other bases (on PvP servers) too easy.

Autocraft does not disallow flying over Faction lands and does not offer such a functionality. And thats where AcController comes in. Its basically an Add-On for Autocraft to be factions-aware. If you fly to near to forbidden territory you get unpiloted and thus stopped.

The plugin requires Autocraft and Factions to be installed. In the standard configuration it allows flying airships only over Wilderness, Warzones and your own factions land. But you can change that. Commands are described below.

Since this is a first developer release theres not much documentation yet and there might be some bugs, though I have done quite some testing. Configuration is done by standard config.yml and / or in-game commands.

It works such, that the pilots distance to foreign territory is checked and if he gets too near he is unpiloted. Piloting on forbidden lands is prohibited and blocked as well as turning your ship to have it float over forbidden lands. The distance to keep the pilot (and its ship) away is the possible size of the airship plus a configurable safetyzone. The ship velocity is taken into account and added to the distance when trying to move.

Commands:

• /acc setdebug (true/false) : enables or disables debug output.
• /acc showsettings : List the currently active settings.
• /acc listallowed : Lists all factions you are allowed to fly over.
• /acc setsafetyzone (int) : adds an additional buffer zone to the allowed distance from foreign land where flying is disallowed.
• /acc setallallowed (true/false) : Flying everywhere !
• /acc setplayerfactionok (true/false) : Flying over Players own land allowed?
• /acc setalliedfactionok (true/false) : Flying over allied factions land allowed?
• /acc addallowed (faction tag) : Add a faction to the list of allowed factions to fly over.
• /acc removeallowed (faction tag) : Remove a faction from the list of allowed factions to fly over.
• /acc saveconfig : Save current settings to file.
• /acc reloadconfig : Reload settings from file and overwrite changes you made in between.

Permissions

Permissions default to "OP" - Operators only.

They refer to the commands listed above.

• accontrol.showsettings: true
• accontrol.listallowed: true
• accontrol.setdebug: true
• accontrol.setallallowed: true
• accontrol.setplayerfactionok: true
• accontrol.setalliedfactionok: true
• accontrol.setsafetyzone: true
• accontrol.addallowed: true
• accontrol.removeallowed: true
• accontrol.saveconfig: true
• accontrol.reloadconfig: true

Installation

Put the plugin into our servers /plugin folder and you're good to go. All is set up after server restart.

Configuration

The Default config.yml:

# debug: debug mode - spits out stuff
# safetyzone: distance to keep away from disallowed factions with ship in blocks
# factions: factions plugin section
# PlayerFactionOK: Flying over players faction allowed?
# AllAllowedOK: Flying everywhere allowed? (Basically switches off the plugin functionality)
# AlliedFactionOK: Flying over allied factions allowed?
# AllowedFactionIds: list with Ids of allowed factions - not tags, since tags can change
# 0= Wilderness, -1=Safezone, -2=Warzone
 
debug: false
safetyzone: 8

factions:
 PlayerFactionOK: true
 AllAllowed: false
 AlliedFactionOK: false
 AllowedFactionIds:
 -  0
 - -2

Source

• https://github.com/McKillroy/accontrol

Dependencies

• Factions: http://dev.bukkit.org/server-mods/factions/
• AutoCraft: http://dev.bukkit.org/server-mods/orange451-autocraft/

.plan

- minor beautifying, maybe deleting the project if AutoCraft decides to incorporate the functionality I programmed here. No idea ....

Stuff and Blurb

Have Fun ! :)