General Features
Planned features:
- integrated factions top
- dynmap integration
- faction level and upgrade system
- advanced command-system
- own faction ranks
- faction relation system
- ally permission system (!)
- different chats (ally, truce, faction, public)
- faction warps (optional with password) (!)
- faction bank system (!)
- faction townhall villager (!)
- faction siege system (!)
- scoreboard tablist header and footer
- 100% configurable messages
- quests system (only for version > 1.13 )
- ...
Planned features:
- DiscordBot (creates channels for each faction / gives channel perms)
- create unlimited faction ranks
- give each rank its own permissions
- add a rank prefix
- set a rank icon
- give your ally its own permissions in your territory
- text your allies in ally chat
![[IMG] [IMG]](https://i.imgur.com/71Asr4l.png)
- /faction help [page] - Help Command
- /faction create <name> - Creates a faction
- /faction join <faction> - Accepts an faction invite
- /faction leave - Leaves your faction
- /faction ignores - Opens a GUI with all of your ignored factions
- /faction ignore <faction> - Ignore the faction invites
- /faction unignore <faction> - Removes a faction from your ignores list
- /faction map - Shows a map of the surrounding chunks
- /faction mapsize <width> <height> - Change the size of the map
- /faction info [faction] - Shows your factions informations
- /faction playerinfo <player> - Shows information about the player
- /faction rename <name> - Sets a new name for your faction
- /faction description <description> - Changes your factions description
- /faction settings - Change some default values of your faction
- /faction invite <player> - Invites a player to your faction
- /faction uninvite <player> - Revoke an faction invite
- /faction chunksee - Shows the chunk border
- /faction claim - Claims a chunk
- /faction claimat <x> <z> - Claims a chunk at a specific position
- /faction unclaim - Unclaims a faction chunk
- /faction autoclaim - Claims a chunk while walking through it
- /faction chat - Toggle chatmode
- /faction setwarp <name> [password] - Sets a faction warp with optional password
- /faction warp <name> [password] - Teleport to the specific warp
- /faction warps
- /faction sethome [-f] - Sets your faction home
- /faction home - Teleports you to your faction home
- /faction ranks - Shows your factions ranks
- /faction setrank <player> - Sets a players faction rank
- /faction promote <player> - Promotes a player to the new faction leader
- /faction chest - Opens the faction chest
- /faction ally <faction> - Adds an faction to your ally
- /faction list - Opens a GUI with all factions
- /faction kick <player> - Kicks a player out of your faction
- /faction truce <faction> - Adds a faction to your truces
- /faction neutral <faction> - Removes any relations with a faction
- /faction bank - Shows your factions balance
- /faction deposit <amount> - Deposit money into the factions bank
- /faction withdraw <amount> - Withdraw money into the faction bank
- /faction upgrade - Upgrades your faction level
- /faction disband - Disbands your faction
- /faction safezone - Edit the safe-zone
- /faction warzone - Edit the war-zone
- /faction siege <faction> - Starts a siege
- /faction fly - Toggles fly mode inside your faction territory
- /faction fill - Fill any container with TNT out of your inventory
![[IMG] [IMG]](https://i.imgur.com/7xnsf7A.png)
Permission to create a faction
Code:
ultimatefactions.create
Code:
ultimatefactions.bypass
Code:
ultimatefactions.build
Code:
ultimatefactions.admin
![[IMG] [IMG]](https://i.imgur.com/xo8iyIs.png)
- Vault
- PlaceholderAPI (not required, but recommended)
- Economy System like EssentialsX
- Java 16, Spigot Server
PlaceholderAPI:
![[IMG] [IMG]](https://i.imgur.com/BofpYOv.png)
- Put the UltimateFactions plugin in the plugins folder
- Put Vault and optional PlaceholderAPI plugin in the plugins folder
- Restart (!) your server
![[IMG] [IMG]](https://i.imgur.com/lGjAZ8y.png)
These are the default configuration files. Do not copy them. The plugin will automatically create these files.
YAML:
0:
cost: 0
members: 5
fly: false
fill: false
warps: 2
# teleport cooldown in ticks (20 ticks = 1 second)
warp-cooldown: 100
claims: 5
potion-effects: []
max-active-quests: 1
chest-size: 0
1:
cost: 10000
fly: false
fill: true
members: 10
warps: 5
warp-cooldown: 80
claims: 15
potion-effects:
- jump
max-active-quests: 2
chest-size: 9
2:
cost: 150000
fly: true
fill: true
members: 15
warps: 10
warp-cooldown: 60
claims: 20
potion-effects:
- speed
- regeneration
max-active-quests: 3
chest-size: 18
YAML:
language: "en-US"
# length of a single chunk
# this value is required to be a power of 2 (2^n)
# changing after the server already initialized the chunk universe will shift the size of all chunks and should only be done with caution
chunk-size: 16
# change the name of the command
# if this value gets changed it is required to also change the command name in the plugin.yml [important!]
# [right-click on the plugin.jar -> WinRar/7-Zip -> open -> select plugin.yml]
# aliases can be changed in the plugin.yml too
command: faction
help-page-size: 8
# tooltips are short tip messages that are sent to the user to give him some hints
tooltips:
enabled: true
chat:
# set to false if you don't want to use the integrated chat module
enabled: true
# gets formatted with [faction, player, message]
self: '&8[&a%s&8] &7%s &8> &f%s'
ally: '&8[&9%s&8] &7%s &8> &f%s'
truce: '&8[&e%s&8] &7%s &8> &f%s'
neutral: '&8[&c%s&8] &7%s &8> &f%s'
# gets formatted with [player, message]
none: '&8[] &7%s &8> &f%s'
# gets formatted with the [channel, relation-format]
channelFormat: "&c%s &8| %s"
faction:
name:
# set to true if you want to allow only ASCII characters a faction name
onlyCharacters: true
# maximum length of the factions name
maxLength: 16
creation:
# amount of money a player needs to create a faction
cost: 0
claim:
# list of worlds where a player can't claim a faction chunk
blacklistedWorlds:
- world_nether
- world_the_end
# start price to claim the first x chunks
# can be set to 0 if you want to disable costs of chunks
price: 100
# every x claims the price gets multiplied by the multiplier
# (!) don't set to 0
priceStreak: 5
# multiplier that multiplies the streak with the price
# (!) don't set to 0
multiplier: 1.5
# set to false if players should be able to claim chunks that are not connected to each other
connected: true
# power a faction gains when a player joins the faction
playerPower: 5
warp:
# set to true if players should be allowed to set a warp outside the faction territory
outsideChunk: false
power:
# amount of power that will be regenerated every #increaseTime seconds
# for each faction
increase: 5.0
# time in seconds
increaseTime: 300
# power a faction will generate if a player kills another player
increaseOnKill: 1.25
# power a faction will lose if a player gets killed
decreaseOnDeath: 1.25
teleport:
# fallback teleport delay in ticks (20 ticks = 1 second)
delay: 60
# set to true if you want to disable enemy teleports in faction territory
# (blocks every teleportation)
blockEnemy: true
map:
# default size of the map
# is required to be an odd number
width: 17
height: 17
siege:
# power a faction needs to be besieged
neededPower: 0
# time in seconds
# in this time the besieging faction gets all permissions in the
# besieged factions claims
siegeTime: 300
# time in seconds
# time the besieged faction is unsiegable after a siege
graceTime: 300
fly:
# time in seconds
# if a player leaves a faction chunk while enabled /f fly
# fly will be deactivated after this amount of time
leaveTime: 3
gui:
# enter the name of a material
# this material will fill each empty space around an item in any gui that is created by the plugin
# set to 'null' if you don't want to use any item
fillItem: 'BLACK_STAINED_GLASS_PANE'
display:
scoreboard:
# set to true if you want to enable the sidebar
enabled: true
tablist:
# set to true if you want to enable tablist header and footers
enabled: true