◈ Overview
EliteFaction is a Minecraft Bedrock scripted add-on that delivers a full faction-server experience: territory claiming, a player economy, diplomacy, war & raiding, missions, an auction house, and a moderation suite — all driven by a single behavior pack with no external server software required.
All commands use the ! prefix. Faction-specific commands use !f. A GUI-based menu is available via !f item.
config.js via the FEATURE_FLAGS object before they become available in-game.
⊞ Installation
- Download EliteFaction-0_2_mcaddon.zip and rename it to
EliteFaction-0_2.mcaddon(change extension from.zipto.mcaddon). - Double-click the
.mcaddonfile. Minecraft will import both the Behavior Pack and Resource Pack automatically. - Create or open a world. In World Settings → Add-Ons, activate EliteFaction BP under Behavior Packs and EliteFaction RP under Resource Packs.
- Enable Beta APIs (Experiments) in world settings — required for the
@minecraft/server 2.6.0-betascripting module. - Grant yourself the
admintag in-game to access admin commands:/tag @s add admin - Optionally open
BP/scripts/config.jsin a text editor to tune costs, limits, and enable feature flags before loading the world.
⊟ Feature Flags
Controlled in config.js → FEATURE_FLAGS. Flags marked phase3 or higher are off by default.
⚑ Factions
Players create and join factions to collaborate on land claiming, economy, and combat. Names must be 3–20 characters and match [A-Za-z0-9 _-].
Creating & Joining
| Command | Description |
|---|---|
| !team create <name> | Create a new faction. You become the leader. |
| !team join <name> | Request to join an existing faction. |
| !team accept <player> | Accept a pending join request (leader/captain). |
| !team leave | Leave your current faction. |
| !team info [faction] | Show faction details. Defaults to your own. |
| !team list | List all factions. |
Faction Management
| Command | Description |
|---|---|
| !f info [faction] | Detailed faction info panel. |
| !f set <field> <value> | Set a faction field (tag, color, prefix, banner, trail). |
| !f customize | Open the cosmetics GUI. |
| !f top | Faction leaderboard. |
| !f item | Receive the faction menu item (opens full GUI). |
| !f help | In-game help browser. |
| !f map [radius] | ASCII claim map centered on your position. |
Warps
Faction warps let members fast-travel to preset locations. home is a reserved warp name.
| Command | Description |
|---|---|
| !f setwarp <name> | Set a named faction warp at your position. |
| !f warp <name> | Teleport to a faction warp. |
| !f delwarp <name> | Delete a faction warp. |
| !f warps | List all faction warps. |
▣ Claims & Land
Factions protect land by purchasing claim blocks and using the golden shovel to select corners of an area. Claimed land prevents outsiders from building or breaking blocks.
minecraft:golden_shovel — right-click two corners to define the claim area. Max area: 10,000 blocks. Cost: $5/block. Sell rate: $3/block.
Claiming Land
| Command | Description |
|---|---|
| !f claim buy | Confirm purchase of the selected claim area. |
| !f claim sell | Release and sell back a claim you are standing in. |
| !f claim info | Show info about the claim you are standing in. |
| !f claim list | List all of your faction's claims. |
| !f claim cancel | Cancel an in-progress claim selection. |
| !f claimblocks | Show faction's current claim block balance. |
| !f claimblocks buy <n> | Purchase additional claim blocks. |
Trust & Access
| Command | Description |
|---|---|
| !f claim trust <player> | Allow a player to build in your claim. |
| !f untrust <player> | Revoke a player's build access. |
Advanced Claims phase3_warraid
| Command | Description |
|---|---|
| !f claim visualize <particles|blocks> [sec] | Show claim borders visually. |
| !f claim transfer <faction> | Transfer a claim to another faction (e.g., war prize). |
| !f claim landmark <set|list|remove> | Manage named landmark points within claims. |
◆ Power & Upgrades
Factions earn power points through activity (kills, missions, etc.). Power determines faction level, which unlocks upgrades and increases vault capacity and warp slots.
| Command | Description |
|---|---|
| !f power | Show your faction's current power and level. |
| !f power top | Leaderboard of top factions by power. |
| !f upgrade <upgradeId> | Purchase a faction upgrade using power points. |
home_territory_buffs_v1 (on by default).
◈ Ranks
Custom faction roles with granular permissions. Leaders can create roles, assign permission nodes, and apply pre-built templates.
| Command | Description |
|---|---|
| !f rank list | List all faction ranks and their permissions. |
| !f rank create <name> | Create a new rank. |
| !f rank delete <name> | Delete a rank. |
| !f rank perms <rank> <add|remove|show> <perm> | Manage permissions for a rank. |
| !f rank assign <player> <rank> | Assign a rank to a faction member. |
| !f rank unassign <player> | Remove a player's rank assignment. |
| !f rank templates | List available rank templates. |
| !f rank template <rank> <templateName> | Apply a template's permissions to a rank. |
☍ Diplomacy
Factions negotiate alliances and truces. Pacts must be accepted by both parties and can be broken unilaterally (with penalties if diplomacy_penalties_v1 is enabled).
| Command | Description |
|---|---|
| !f ally <faction> | Propose an alliance with another faction. |
| !f truce <faction> | Propose a truce. |
| !f pact accept <faction> | Accept a pending pact proposal. |
| !f pact deny <faction> | Reject a pact proposal. |
| !f pact break <faction> | Unilaterally end an active pact. |
⚔ War & Raids phase3_warraid
Declared wars allow factions to raid each other's claimed territory. Raid windows can be restricted by admins to specific times. War has a cooldown and requires mutual agreement (unless declined).
War Commands
| Command | Description |
|---|---|
| !f war <faction> [stake] | Declare war. Optional resource stake requires phase3. |
| !f war accept <faction> | Accept an incoming war declaration. |
| !f war decline <faction> | Decline a war declaration. |
| !f war ceasefire <faction> | Propose a ceasefire during active war. phase3 |
| !f raidstatus | Check whether raiding is currently permitted and why. |
Raid Protection Rules
Raids can be blocked by the following conditions (shown by !f raidstatus):
| Condition | Meaning |
|---|---|
| grace | Map reset grace period is active. |
| window | Outside the admin-configured raid window. |
| offline | Defender offline protection is active. |
| shield | Defender has an active raid shield. |
| war | No active war exists between the factions. |
◉ Missions phase2_missions
Missions are tracked objectives that reward factions with power points and money on completion. Enable phase2_missions in config to activate.
| Command | Description |
|---|---|
| !f missions | List available missions and progress. |
| !f mission claim <missionId> | Claim the reward for a completed mission. |
$ Currency
The server uses a scoreboard-backed currency (money objective). Players earn money by selling items and completing missions; spend it in the shop and auction house.
| Command | Description |
|---|---|
| !bal / !balance | Check your current balance. |
| !pay <player> <amount> | Transfer money to another player. Max: $1,000,000,000. |
| !baltop | Richest players leaderboard. |
⊡ Shop
A chest-UI shop with categories, quantity cycling, buy preview, and a sell GUI. Tax from !f vault tax applies to shop transactions.
| Command | Description |
|---|---|
| !shop | Open the shop browser GUI. |
| !sell | Sell the item currently held in your hand. |
| !sellall | Sell all sellable items in your inventory at once. |
| !sellgui | Open the sell GUI to select items to sell. |
Default Prices (selected)
config.js → SHOP_ITEMS. Add or remove items by editing that object.
⬡ Auction House
Players list items for direct purchase. Listings are identified by a numeric ID. Use !ah browse to discover active listings.
| Command | Description |
|---|---|
| !ah / !ah browse | Browse active auction listings. |
| !ah sell <price> [amount] | List held item(s) for sale at the given price. |
| !ah buy <listingId> | Purchase a specific listing by ID. |
| !ah cancel <listingId> | Cancel and reclaim your own listing. |
▭ Faction Vault
A shared faction treasury. Vault capacity scales with faction level/upgrades. A tax rate (0–15%) is deducted from member transactions and deposited automatically.
| Command | Description |
|---|---|
| !f vault | View vault balance and capacity. |
| !f vault deposit <amount> | Deposit money into the faction vault. |
| !f vault withdraw <amount> | Withdraw money from the vault (leader/captain). |
| !f vault tax <0-15> | Set the faction tax rate (% deducted from pay & shop). |
| !f vault ledger [page] | View transaction history. |
↝ Teleportation
All teleport commands share a 120-second cooldown and a 5-second warmup (moving cancels it). Combat-tagged players cannot teleport.
| Command | Description |
|---|---|
| !tpa <player> | Send a teleport request to a player. Expires after 60 seconds. |
| !tpaccept | Accept an incoming TPA request. |
| !tpdecline | Decline an incoming TPA request. |
| !tpcancel | Cancel your own pending TPA request. |
| !home [name] | Teleport to your personal home or a faction warp named home. |
| !spawn / !rtp | Random teleport (500–10,000 blocks from origin). 5-minute cooldown. |
☷ Chat
Players can toggle between public, faction, and alliance chat channels. Faction and alliance messages are only visible to respective members.
| Command | Description |
|---|---|
| !f chat <team|alliance|public|toggle> | Switch or toggle your active chat channel. |
| !f c <message> | Send a single message to faction chat without switching channels. |
| !f ac <message> | Send to alliance chat. phase4_admin |
⊛ Moderation
Mutes and bans are time-based. Duration format uses days; max mute duration is 365 days. Ban commands require phase4_admin.
| Command | Description | |
|---|---|---|
| !mute <player> <duration> | Mute a player for the given duration. | |
| !unmute <player> | Remove a mute. | |
| !ban <player> <duration> [reason] | Ban a player. | phase4 |
| !unban <player> | Unban a player. | phase4 |
| !banlist [page] | View the active ban list. | phase4 |
⊕ Admin Commands
Requires the admin tag. Grant it with /tag <player> add admin.
phase4_admin: true in config.
| Command | Description | |
|---|---|---|
| !admin gui | Open the admin control panel GUI. | |
| !admin team | Admin faction management panel. | |
| !admin audit [page|text <page>] | View the action audit log. | phase4 |
| !admin test run <suite> | Run a smoke test. Suites: smoke, economy, warraid, claims, moderation. | |
| !admin mapreset now | Trigger an immediate map reset. | |
| !admin raidwindow <set|list|clear> | Configure allowed raid windows. | |
| !admin hologram set <id> | Place a hologram anchor at your position. | |
| !admin faction set ... | Force-set a faction property. | |
| !admin faction inspect <name> | Deep inspect faction data. | phase4 |
| !f notify [page] | View admin notifications. | phase4 |
| !f ac <msg> | Broadcast to all alliance channels. | phase4 |
◫ Localization
EliteFaction ships with 10 built-in locales. Players can switch language with a command; all UI strings update immediately.
| Code | Language |
|---|---|
| en_us | English (US) — default |
| es_es | Spanish |
| fr_fr | French |
| pt_br | Portuguese (Brazil) |
| pt_pt | Portuguese (Portugal) |
| ru_ru | Russian |
| zh_cn | Chinese (Simplified) |
| ar_sa | Arabic |
| hi_in | Hindi |
| bn_bd | Bengali |
| id_id | Indonesian |
To add a new locale, copy BP/scripts/i18n/locales/en_us.js, translate the values, and register it in BP/scripts/i18n/index.js.
⚙ Config Reference
All tunable values live in BP/scripts/config.js. Edit before loading the world.
| Key | Default | Description |
|---|---|---|
| PREFIX | ! | Command prefix character. |
| ADMIN_TAG | admin | Tag that grants admin access. |
| MONEY_OBJECTIVE | money | Scoreboard objective for currency. |
| CLAIM_COST_PER_BLOCK | 5 | Cost in $ to claim one block of area. |
| CLAIM_SELL_RATE | 3 | $ returned per block when selling a claim. |
| CLAIM_TOOL | golden_shovel | Item used to select claim corners. |
| MAX_CLAIM_AREA | 10000 | Maximum XZ area per single claim. |
| TPA_TIMEOUT_TICKS | 1200 | TPA request expiry (1200 = 60 s). |
| RTP_MAX_RANGE | 10000 | Max XZ distance for random teleport. |
| RTP_MIN_RANGE | 500 | Min XZ distance from 0,0 for RTP. |
| RTP_COOLDOWN_SECONDS | 300 | Cooldown between RTP uses (seconds). |
| MAX_TRANSFER_AMOUNT | 1,000,000,000 | Max single payment amount. |
| MAX_MUTE_DAYS | 365 | Maximum mute duration in days. |
| SHOP_PAGE_SIZE | 27 | Items per shop page. |
| TEAM_NAME_MIN_LENGTH | 3 | Minimum faction name length. |
| TEAM_NAME_MAX_LENGTH | 20 | Maximum faction name length. |