Bukkit

EpControl

This is a plugin for Bukkit to control the teleport behavior of enderpearls using the factions plugin functionality. It allows to teleport using enderpearls into the players faction territory, Wilderness, SafeZone and Warzone. It blocks enderpearl teleportation into foreign factions territory.

The consequence is, you cannot just use enderpearls to go into a foreign base which is protected by walls - you need other means, like TNT person cannons or plugins like airships or parachutes. The allowed landing zones can be configured from inside the plugin, there is no sophisticated config yet. Basically the plugin catches the teleport event and cancels it if the teleport is caused by an enderpearl and the landing zone conditions are met. Check the code - its easy. Without factions the plugin just breaks and does nothing but spitting out error messages into your server log.

Language

"To Enderpearl" (capital "E") here is a verb to abbreviate "to teleport using an enderpearl".

Installation:

1. Install and configure Factions - http:dev.bukkit.org/server-mods/factions/
2. Put the EpControl.jar file into your servers plugin directory
3. Restart server and enjoy

The PythonPluginLoader is no longer needed since the project is now a native Java plugin!!!

The page for the old initial python version of the plugin which now is in java can be found here:
http://dev.bukkit.org/server-mods/enderpearlcheck/pages/the-old-python-version/

Keep in mind this is a first developer version - so there isn't much documentation or configuration.

Configuration:

Standard config.yml. Plugin creates a default file if none is supplied.

config.yml

# debuglevel: The higher the more it spits out stuff
# factions: factions plugin section
# PlayerFactionOK: Enderpearling into players own faction allowed? (true = yes)
# AlliedFactionOK: Enderpearling into allied factions allowed? (true = yes)
# AllAllowed: Enderpearling into any area allowed? (true = yes; basically switches off this plugins functionality)
# AllowedFactionIds: list with Ids of allowed factions to Enderpearl into
# 0=Wilderness, -1 = SafeZone, -2 = Warzone
# For other Faction IDs please look into the Factions plugin "factions.json" file
 
debuglevel: 0

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

Commands

Use /epcontrol or /epc as main command. All commands are case insensitive.
/epc, /epc help: Show this help message.
/epc debuglevel [integer]: Set Debuglevel. 0 = off
/epc show: Show currently active settings in memory.
/epc reload: Reload settings from file.
/epc save: Save current settings to file.
/epc allowAll [true / false]: Allow Enderpearling into any place (=true)
/epc allowAllied [true / false]: Allow Enderpearling into allied factions (=true)
/epc allowSelf [true / false]: Allow Enderpearling into players own faction (=true)
/epc add [faction tag]: Add faction to list of allowed factions to Enderpearl into.
/epc remove [faction tag]: Remove faction from list of allowed factions to Enderpearl into.
/epc list: Show list of allowed factions to Enderpearl into.

permissions

The permission nodes refer to the available commands.
default: op
epcontrol.show: true
epcontrol.list: true
epcontrol.debuglevel: true
epcontrol.help: true
epcontrol.allowall: true
epcontrol.allowself: true
epcontrol.allowallied: true
epcontrol.add: true
epcontrol.remove: true
epcontrol.save: true
epcontrol.reload: true

.plan:

1. Implement the following commands:
   /epc List: Lists all factions (tags) you are allowed to Enderpearl into
   /epc AllAllowed (true/false) : Enderpearls everywhere !
   /epc AllowSelf (true/false) : Enderpearling into players own land allowed?
   /epc AlliedAllowed (true/false) : Enderpearling into allied factions allowed?
   /epc add (faction tag) : Add a faction to the list of allowed factions to Enderpearl into.
   /epc remove (faction tag) : Remove a faction from the list of allowed factions to Enderpearl into.
   

1. Allow a config to set allowed factions easier for non-coders
2. Allow configuration for different worlds
3. Maybe use faction IDs instead of -tags to configure
4. Add support for Towny, Worldguard, etc ...
5. Port it to be a native Java plugin in the future

Latest:

After approval the link will be: http://dev.bukkit.org/media/files/664/519/EpControl.jar

Blurb:

Have fun !