CommandEssentials is a large all-in-one plugin suite designed for factions and competitive survival servers.
Instead of stacking many small plugins together, CommandEssentials brings your core server systems into one modular package with one admin dashboard, one configuration style, and one release to manage.
Main highlights:
- Combat timer with configurable punishments
- Staff vanish with hidden join/quit presence
- Player vaults
- EssentialsX kit and warp GUIs
- Animated MOTD, tab list, and scoreboard
- Directional generator buckets with economy pricing
- Public shop and selling features
- Booster gems for XP and money
- XP and money pouches with five tiers each
- Custom enchants with an XP shop GUI
- Advanced crates, monthly voucher rolls, and holograms
- Voucher creation for custom redeemable rewards
- Chest-based crop and mob-drop collectors
- Custom mob drops and spawn-rate tuning
- In-game admin dashboard with module controls
The plugin is built around Minecraft 1.8-style compatibility while still aiming to load on newer Spigot and Paper servers.
- id: "requirements"
title: "Requirements"
icon: "ANVIL"
content: |
Recommended requirements before installing:
- Java 8 or newer
- Spigot or Paper
- Vault for economy-backed systems
- A Vault-compatible economy plugin
- EssentialsX for the kit and warp GUIs
Optional integrations:
- PlaceholderAPI for advanced placeholders in displays
- ProtocolLib if your server setup needs stronger vanish compatibility with other plugins
- Protection and land plugins can still be used alongside the plugin
Important note:
Always test on a staging server first, especially if you run a large custom stack or an older factions setup.
- id: "installation"
title: "Installation"
icon: "CHEST"
content: |
Quick setup:
1. Stop the server.
2. Install Vault and your economy plugin if you want paid features.
3. Install EssentialsX if you want the kits and warps GUI.
4. Place CommandEssentials in your plugins folder.
5. Start the server once so the plugin generates its files.
6. Review the configuration files and edit your pricing, displays, rewards, and module settings.
7. Restart the server or use /ce reload after simple config changes.
Generated files you will use most:
- config.yml
- shop.yml
- crates.yml
- enchants.yml
- mobs.yml
- vouchers.yml
Storage notes:
- Booster data is persisted in SQLite
- Special items are signed to help prevent fake copies
- Rolling backups are created for important persisted data
- id: "quick-start"
title: "First 10 Minutes"
icon: "WATCH"
content: |
If you want the plugin feeling live quickly, do these first:
1. Run /settings and look through the admin dashboard.
2. Set your generator prices in config.yml.
3. Edit the animated MOTD, tab list, and scoreboard with your server name and store links.
4. Open /shop and add your main categories and prices.
5. Open /crate and create your first crate.
6. Run /monthly and confirm the monthly voucher flow.
7. Open /customenchants and test the XP enchant GUI.
8. Run /booster admin, /collector, /pouch, and /voucher to test your admin item menus.
9. Place a crate and check the hologram.
10. Test /sell, /sellhand, /sellall, and collector selling with your shop prices.
Best first commands to test:
- /ce status
- /settings
- /shop
- /gb
- /customenchants
- /crate
- /monthly
- /booster
- /collector
- /pouch
- id: "modules"
title: "Modules"
icon: "REDSTONE_COMPARATOR"
content: |
Every major feature can be turned on or off in the modules section of config.yml, and the dashboard provides quick module controls in game.
Current modules:
- combat-timer
- vanish
- gen-buckets
- motd
- boosters
- shop
- player-vaults
- essentials-guis
- displays
- selling
- collectors
- custom-enchants
- crates
- mobs
- vouchers
- pouches
This makes the plugin much easier to adapt for networks, factions realms, prisons, or hybrid economy servers.
- id: "commands"
title: "Commands"
icon: "PAPER"
content: |
Core admin:
- /ce or /commandessentials
- /ce reload
- /ce status
- /settings
Staff and utility:
- /v
- /vault
- /kits
- /warps
Economy:
- /shop
- /sell
- /sellhand
- /sellall
Generators:
- /gb
- /gb <material>
Boosters:
- /booster
- /booster admin
- /booster <player> <xp|money> <multiplier> <minutes>
Pouches:
- /pouch
- /pouch give <player> <xp|money> <1-5> [amount]
Collectors:
- /collector
- /collector <player> <chest|crop>
Custom enchants:
- /customenchants
- /customenchant <player> <enchant> <level>
Crates and monthly:
- /crate
- /crate create <id>
- /crate delete <id>
- /crate set <id>
- /crate key <player> <id> [amount]
- /crate placer <player> <id>
- /crate additem <id> <weight>
- /crate addmoney <id> <weight> <amount>
- /monthly
- /monthly admin
- /monthly give <player> [amount]
Vouchers:
- /voucher
- /voucher create <reward command>
- /voucher give <player> <id> [amount]
- /voucher list
- /voucher delete <id>
- /voucher cancel
Mob drops:
- /mobdrops set <mob> <material> <min> <max> <chance>
- /mobdrops list <mob>
- /mobdrops remove <mob> <drop-id>
- /mobdrops clear <mob>
- id: "permissions"
title: "Permissions"
icon: "NAME_TAG"
content: |
Main permissions:
- commandessentials.admin
- commandessentials.settings
- commandessentials.reload
- commandessentials.vanish
- commandessentials.vanish.see
- commandessentials.genbucket
- commandessentials.shop
- commandessentials.vault
- commandessentials.kits
- commandessentials.warps
- commandessentials.sell
- commandessentials.give
- commandessentials.booster
- commandessentials.crate.admin
- commandessentials.monthly
- commandessentials.mobdrops.admin
- commandessentials.voucher.admin
- commandessentials.pouch.admin
Suggested setup:
- Give regular players only the public feature permissions they should access
- Keep admin creation tools behind op or an owner/staff group
- Give vanish view permission only to staff who should see hidden staff
- id: "combat"
title: "Combat And Vanish"
icon: "IRON_SWORD"
content: |
Combat timer:
- Marks players as in combat for a configurable amount of time
- Can block commands like /spawn, /home, /warp, and teleport shortcuts
- Can run a punishment command if a player logs out during combat
PvP XP transfer:
- PvP deaths can keep most of the victim's XP instead of dropping everything
- By default, the victim keeps 85% and the killer gets 15%
- Non-PvP deaths keep vanilla-style behavior unless you choose otherwise in your broader server setup
Staff vanish:
- /v toggles vanish
- Hidden staff are not shown like normal players to regular users
- Reconnect messages are hidden for vanished staff
- Staff visibility is permission-aware
- id: "displays"
title: "MOTD Tab Scoreboard"
icon: "SIGN"
content: |
The plugin includes a full animated display system for:
- Server list MOTD
- Join MOTD
- Tab header and footer
- Scoreboard title and lines
Animation placeholders use this format:
- {anim:brand}
- {anim:status}
- {anim:scoreboard-title}
Display placeholders can include:
- %player%
- %online%
- %max%
- %balance%
- PlaceholderAPI placeholders if installed
Helpful notes:
- Scoreboard lines on 1.8 clients must stay short
- Tab headers and footers support multiple lines with \n
- The default config already includes a polished animated example you can edit
This is a strong feature for owners who want a premium-looking server without using three separate display plugins.
- id: "generators"
title: "Generator Buckets"
icon: "LAVA_BUCKET"
content: |
/gb opens the generator store.
Supported generator types in the default setup:
- Cobblestone
- Sand
- Obsidian
- Netherrack
- Dirt
Generator buckets are directional.
They generate based on the face you click, which means builders can place them in different directions instead of being locked to one shape.
Great for factions because they can be used for walls, raid bases, and grinders while still being controlled by economy pricing.
- id: "shop-and-selling"
title: "Shop And Selling"
icon: "EMERALD"
content: |
The plugin includes both a GUI shop and direct selling commands.
Shop:
- Category-based
- Designed for factions-style economies
- Easy for admins to expand
- Good default categories include blocks, raiding, farming, tools, mob drops, and misc
Selling:
- /sell
- /sellhand
- /sellall
Booster-aware money sources:
Money boosters can be limited to income from sell commands and collectors so they do not affect every possible economy source on the server.
- id: "boosters-and-pouches"
title: "Boosters And Pouches"
icon: "EXP_BOTTLE"
content: |
Booster gems:
- XP boosters and money boosters
- Physical signed items
- Configurable multipliers and duration
- Admin GUI for quickly grabbing preset gems
- /booster shows active boosters and remaining time
Pouches:
- XP pouches and money pouches
- Five tiers each
- Right-click to roll a random reward between configured minimum and maximum values
- Money pouches use Vault
- XP pouches reward raw XP points, not levels
These two systems work great together for crates, seasonal rewards, staff events, and store packages.
- id: "collectors-and-mobs"
title: "Collectors And Mob Drops"
icon: "CHEST"
content: |
Collectors are real chest blocks, not hoppers.
Crop Collector:
- Collects only configured crop harvest drops from its chunk
Mob Drop Collector:
- Collects only mob death drops from its chunk
- Supports both vanilla and custom mob drops
Collector quality-of-life:
- Unlimited virtual storage
- Owner-based protection
- Right-click GUI to inspect contents
- Sell options that use your configured shop values
- Holograms showing type, owner, and stored total
Custom mob drops:
- Add extra drops to any supported mob
- Set material
- Set min and max amount
- Set chance
This is useful for building chunk-based mob farms and custom progression loops.
- id: "enchants"
title: "Custom Enchants"
icon: "ENCHANTED_BOOK"
content: |
/customenchants opens the player-facing enchant GUI.
Players can:
- Spend XP to roll a random enchant book
- Preview available enchants
- Learn the rarity and style of the system before spending levels
Default enchant style:
- Potion-effect based
- Fun and strong without being wildly game-breaking
- Restricted by item type
- Weighted so powerful enchants are rarer
Default examples include:
- Haste
- Speed
- Strength
- Night Owl
- Aquatic
- Inferno Guard
- Springstep
- Rejuvenation
- Guardian
- Vitality
- Aegis
- Phantom
Admins can fully edit enchants in enchants.yml.
- id: "crates"
title: "Crates"
icon: "TRIPWIRE_HOOK"
content: |
Standard crates:
- Physical signed keys
- Reward preview support
- Weighted rewards
- Item or money rewards
- Placeable crate locations
- Holograms above placed crates
- Spin animation with sounds
Monthly system:
- Separate from normal key crates
- Uses a premium signed voucher item
- Right-clicking the voucher runs a 9 reward roll and then 1 bonus reward
- Built to feel more special than a normal crate preview/open cycle
Admin flow:
- Use /crate for editor access
- Use /monthly for monthly preview and distribution
- Use crate placers for easy in-world setup
This is one of the plugin's strongest premium-style features for public servers.
- id: "vouchers"
title: "Vouchers"
icon: "PAPER"
content: |
Vouchers let owners turn commands into claimable reward items.
Example:
/voucher create eco give %player% 10000
After that, the plugin asks for the voucher's display name in chat.
Good example voucher ideas:
- $10,000 Money Voucher
- 30 Level XP Voucher
- Supply Crate Key Voucher
- Rank Trial Voucher
- Seasonal Reward Voucher
Why this is useful:
- Great for crates
- Great for events
- Great for staff rewards
- Great for webstore delivery
- Great for limited-time seasonal content
- id: "config-files"
title: "Config Files"
icon: "BOOK_AND_QUILL"
content: |
config.yml
Main settings file. Controls enabled modules, combat rules, displays, generators, boosters, pouches, collectors, vault defaults, and more.
shop.yml
Shop categories, item pricing, and sell values.
crates.yml
Standard crates, keys, placed crate behavior, monthly rewards, holograms, sounds, and reward pools.
enchants.yml
Custom enchant definitions, weights, item restrictions, and effect settings.
mobs.yml
Custom mob drops and mob-related configuration.
vouchers.yml
Saved voucher definitions created by admins.
data.db
SQLite storage used for persisted runtime data such as boosters.
- id: "admin-dashboard"
title: "Admin Dashboard"
icon: "NETHER_STAR"
content: |
/settings opens the main administration dashboard.
What it helps with:
- Quick navigation to major systems
- Module toggles
- Feature shortcuts
- Health checks
- Reload access
- Status visibility
The dashboard is made for fast server management, while detailed values still live in the proper config files where they are easier to maintain cleanly.
- id: "compatibility"
title: "Compatibility"
icon: "BEACON"
content: |
Compatibility target:
- Java 8 bytecode
- Spigot 1.8.8 style API surface
- Intended to remain loadable on newer Bukkit-compatible servers
Real-world note:
No large gameplay plugin can guarantee identical behavior on every single fork, plugin stack, placeholder set, vanish stack, or protection setup from 1.8 through latest.
You should always test:
- Combat tagging
- Scoreboard formatting
- Generator behavior
- Economy payouts
- Collectors
- Crates
- Essentials integration
- Placeholder output
- id: "faq"
title: "FAQ"
icon: "COMPASS"
content: |
Q: Do I need Vault?
A: You need Vault for economy-backed systems like money pouches, boosters, shop payouts, and generator purchases.
Q: Do I need EssentialsX?
A: Only if you want the kit and warp GUI features.
Q: Can I disable features I do not want?
A: Yes. The plugin is modular and major systems can be disabled.
Q: Can owners edit most things?
A: Yes. The project was designed to give owners a lot of control through config files, commands, and admin menus.
Q: Are special items protected from fake copies?
A: Yes. High-value plugin items are signed.
Q: Can this replace several plugins at once?
A: Yes, that is one of the main goals of the project.
- id: "support"
title: "Support Notes"
icon: "FEATHER"
content: |
Before asking for support, please check:
- Vault is installed if you use money features
- EssentialsX is installed if you use kits and warps
- Your economy plugin is actually hooked into Vault
- Placeholder names are correct for your server
- Your scoreboard lines are short enough for 1.8 clients
- You reloaded or restarted after config edits
Best support information to provide:
- Server version
- Plugin version
- Full error message
- What command or action caused the issue
- Which optional plugins are installed
marketing:
short-description: "A premium all-in-one factions essentials suite with crates, boosters, collectors, vouchers, enchants, displays, shop, generators, and admin tools."
feature-callouts:
- "Animated MOTD, tab, and scoreboard examples included"
- "Advanced crates with holograms, preview support, sounds, and monthly vouchers"
- "Directional generator buckets for factions economies"
- "Collectors, custom mob drops, and sell integration"
- "Custom enchants, pouches, vouchers, and boosters"
- "Modular design with in-game admin controls"
keywords:
- "factions"
- "essentials"
- "crates"
- "boosters"
- "collectors"
- "custom enchants"
- "generator buckets"
- "shop"
- "voucher"
- "scoreboard"
editor-notes:
purpose: "This file is written as a reusable documentation source for a BuiltByBit resource page, wiki system, or internal documentation export."
tips:
- "Replace example IPs, links, and branding with your real server identity before publishing."
- "If you sell this resource publicly, keep the Overview, Requirements, Installation, Commands, Permissions, and FAQ pages intact."
- "For a cleaner sales page, the marketing.short-description and marketing.feature-callouts can be reused directly."
Instead of stacking many small plugins together, CommandEssentials brings your core server systems into one modular package with one admin dashboard, one configuration style, and one release to manage.
Main highlights:
- Combat timer with configurable punishments
- Staff vanish with hidden join/quit presence
- Player vaults
- EssentialsX kit and warp GUIs
- Animated MOTD, tab list, and scoreboard
- Directional generator buckets with economy pricing
- Public shop and selling features
- Booster gems for XP and money
- XP and money pouches with five tiers each
- Custom enchants with an XP shop GUI
- Advanced crates, monthly voucher rolls, and holograms
- Voucher creation for custom redeemable rewards
- Chest-based crop and mob-drop collectors
- Custom mob drops and spawn-rate tuning
- In-game admin dashboard with module controls
The plugin is built around Minecraft 1.8-style compatibility while still aiming to load on newer Spigot and Paper servers.
- id: "requirements"
title: "Requirements"
icon: "ANVIL"
content: |
Recommended requirements before installing:
- Java 8 or newer
- Spigot or Paper
- Vault for economy-backed systems
- A Vault-compatible economy plugin
- EssentialsX for the kit and warp GUIs
Optional integrations:
- PlaceholderAPI for advanced placeholders in displays
- ProtocolLib if your server setup needs stronger vanish compatibility with other plugins
- Protection and land plugins can still be used alongside the plugin
Important note:
Always test on a staging server first, especially if you run a large custom stack or an older factions setup.
- id: "installation"
title: "Installation"
icon: "CHEST"
content: |
Quick setup:
1. Stop the server.
2. Install Vault and your economy plugin if you want paid features.
3. Install EssentialsX if you want the kits and warps GUI.
4. Place CommandEssentials in your plugins folder.
5. Start the server once so the plugin generates its files.
6. Review the configuration files and edit your pricing, displays, rewards, and module settings.
7. Restart the server or use /ce reload after simple config changes.
Generated files you will use most:
- config.yml
- shop.yml
- crates.yml
- enchants.yml
- mobs.yml
- vouchers.yml
Storage notes:
- Booster data is persisted in SQLite
- Special items are signed to help prevent fake copies
- Rolling backups are created for important persisted data
- id: "quick-start"
title: "First 10 Minutes"
icon: "WATCH"
content: |
If you want the plugin feeling live quickly, do these first:
1. Run /settings and look through the admin dashboard.
2. Set your generator prices in config.yml.
3. Edit the animated MOTD, tab list, and scoreboard with your server name and store links.
4. Open /shop and add your main categories and prices.
5. Open /crate and create your first crate.
6. Run /monthly and confirm the monthly voucher flow.
7. Open /customenchants and test the XP enchant GUI.
8. Run /booster admin, /collector, /pouch, and /voucher to test your admin item menus.
9. Place a crate and check the hologram.
10. Test /sell, /sellhand, /sellall, and collector selling with your shop prices.
Best first commands to test:
- /ce status
- /settings
- /shop
- /gb
- /customenchants
- /crate
- /monthly
- /booster
- /collector
- /pouch
- id: "modules"
title: "Modules"
icon: "REDSTONE_COMPARATOR"
content: |
Every major feature can be turned on or off in the modules section of config.yml, and the dashboard provides quick module controls in game.
Current modules:
- combat-timer
- vanish
- gen-buckets
- motd
- boosters
- shop
- player-vaults
- essentials-guis
- displays
- selling
- collectors
- custom-enchants
- crates
- mobs
- vouchers
- pouches
This makes the plugin much easier to adapt for networks, factions realms, prisons, or hybrid economy servers.
- id: "commands"
title: "Commands"
icon: "PAPER"
content: |
Core admin:
- /ce or /commandessentials
- /ce reload
- /ce status
- /settings
Staff and utility:
- /v
- /vault
- /kits
- /warps
Economy:
- /shop
- /sell
- /sellhand
- /sellall
Generators:
- /gb
- /gb <material>
Boosters:
- /booster
- /booster admin
- /booster <player> <xp|money> <multiplier> <minutes>
Pouches:
- /pouch
- /pouch give <player> <xp|money> <1-5> [amount]
Collectors:
- /collector
- /collector <player> <chest|crop>
Custom enchants:
- /customenchants
- /customenchant <player> <enchant> <level>
Crates and monthly:
- /crate
- /crate create <id>
- /crate delete <id>
- /crate set <id>
- /crate key <player> <id> [amount]
- /crate placer <player> <id>
- /crate additem <id> <weight>
- /crate addmoney <id> <weight> <amount>
- /monthly
- /monthly admin
- /monthly give <player> [amount]
Vouchers:
- /voucher
- /voucher create <reward command>
- /voucher give <player> <id> [amount]
- /voucher list
- /voucher delete <id>
- /voucher cancel
Mob drops:
- /mobdrops set <mob> <material> <min> <max> <chance>
- /mobdrops list <mob>
- /mobdrops remove <mob> <drop-id>
- /mobdrops clear <mob>
- id: "permissions"
title: "Permissions"
icon: "NAME_TAG"
content: |
Main permissions:
- commandessentials.admin
- commandessentials.settings
- commandessentials.reload
- commandessentials.vanish
- commandessentials.vanish.see
- commandessentials.genbucket
- commandessentials.shop
- commandessentials.vault
- commandessentials.kits
- commandessentials.warps
- commandessentials.sell
- commandessentials.give
- commandessentials.booster
- commandessentials.crate.admin
- commandessentials.monthly
- commandessentials.mobdrops.admin
- commandessentials.voucher.admin
- commandessentials.pouch.admin
Suggested setup:
- Give regular players only the public feature permissions they should access
- Keep admin creation tools behind op or an owner/staff group
- Give vanish view permission only to staff who should see hidden staff
- id: "combat"
title: "Combat And Vanish"
icon: "IRON_SWORD"
content: |
Combat timer:
- Marks players as in combat for a configurable amount of time
- Can block commands like /spawn, /home, /warp, and teleport shortcuts
- Can run a punishment command if a player logs out during combat
PvP XP transfer:
- PvP deaths can keep most of the victim's XP instead of dropping everything
- By default, the victim keeps 85% and the killer gets 15%
- Non-PvP deaths keep vanilla-style behavior unless you choose otherwise in your broader server setup
Staff vanish:
- /v toggles vanish
- Hidden staff are not shown like normal players to regular users
- Reconnect messages are hidden for vanished staff
- Staff visibility is permission-aware
- id: "displays"
title: "MOTD Tab Scoreboard"
icon: "SIGN"
content: |
The plugin includes a full animated display system for:
- Server list MOTD
- Join MOTD
- Tab header and footer
- Scoreboard title and lines
Animation placeholders use this format:
- {anim:brand}
- {anim:status}
- {anim:scoreboard-title}
Display placeholders can include:
- %player%
- %online%
- %max%
- %balance%
- PlaceholderAPI placeholders if installed
Helpful notes:
- Scoreboard lines on 1.8 clients must stay short
- Tab headers and footers support multiple lines with \n
- The default config already includes a polished animated example you can edit
This is a strong feature for owners who want a premium-looking server without using three separate display plugins.
- id: "generators"
title: "Generator Buckets"
icon: "LAVA_BUCKET"
content: |
/gb opens the generator store.
Supported generator types in the default setup:
- Cobblestone
- Sand
- Obsidian
- Netherrack
- Dirt
Generator buckets are directional.
They generate based on the face you click, which means builders can place them in different directions instead of being locked to one shape.
Great for factions because they can be used for walls, raid bases, and grinders while still being controlled by economy pricing.
- id: "shop-and-selling"
title: "Shop And Selling"
icon: "EMERALD"
content: |
The plugin includes both a GUI shop and direct selling commands.
Shop:
- Category-based
- Designed for factions-style economies
- Easy for admins to expand
- Good default categories include blocks, raiding, farming, tools, mob drops, and misc
Selling:
- /sell
- /sellhand
- /sellall
Booster-aware money sources:
Money boosters can be limited to income from sell commands and collectors so they do not affect every possible economy source on the server.
- id: "boosters-and-pouches"
title: "Boosters And Pouches"
icon: "EXP_BOTTLE"
content: |
Booster gems:
- XP boosters and money boosters
- Physical signed items
- Configurable multipliers and duration
- Admin GUI for quickly grabbing preset gems
- /booster shows active boosters and remaining time
Pouches:
- XP pouches and money pouches
- Five tiers each
- Right-click to roll a random reward between configured minimum and maximum values
- Money pouches use Vault
- XP pouches reward raw XP points, not levels
These two systems work great together for crates, seasonal rewards, staff events, and store packages.
- id: "collectors-and-mobs"
title: "Collectors And Mob Drops"
icon: "CHEST"
content: |
Collectors are real chest blocks, not hoppers.
Crop Collector:
- Collects only configured crop harvest drops from its chunk
Mob Drop Collector:
- Collects only mob death drops from its chunk
- Supports both vanilla and custom mob drops
Collector quality-of-life:
- Unlimited virtual storage
- Owner-based protection
- Right-click GUI to inspect contents
- Sell options that use your configured shop values
- Holograms showing type, owner, and stored total
Custom mob drops:
- Add extra drops to any supported mob
- Set material
- Set min and max amount
- Set chance
This is useful for building chunk-based mob farms and custom progression loops.
- id: "enchants"
title: "Custom Enchants"
icon: "ENCHANTED_BOOK"
content: |
/customenchants opens the player-facing enchant GUI.
Players can:
- Spend XP to roll a random enchant book
- Preview available enchants
- Learn the rarity and style of the system before spending levels
Default enchant style:
- Potion-effect based
- Fun and strong without being wildly game-breaking
- Restricted by item type
- Weighted so powerful enchants are rarer
Default examples include:
- Haste
- Speed
- Strength
- Night Owl
- Aquatic
- Inferno Guard
- Springstep
- Rejuvenation
- Guardian
- Vitality
- Aegis
- Phantom
Admins can fully edit enchants in enchants.yml.
- id: "crates"
title: "Crates"
icon: "TRIPWIRE_HOOK"
content: |
Standard crates:
- Physical signed keys
- Reward preview support
- Weighted rewards
- Item or money rewards
- Placeable crate locations
- Holograms above placed crates
- Spin animation with sounds
Monthly system:
- Separate from normal key crates
- Uses a premium signed voucher item
- Right-clicking the voucher runs a 9 reward roll and then 1 bonus reward
- Built to feel more special than a normal crate preview/open cycle
Admin flow:
- Use /crate for editor access
- Use /monthly for monthly preview and distribution
- Use crate placers for easy in-world setup
This is one of the plugin's strongest premium-style features for public servers.
- id: "vouchers"
title: "Vouchers"
icon: "PAPER"
content: |
Vouchers let owners turn commands into claimable reward items.
Example:
/voucher create eco give %player% 10000
After that, the plugin asks for the voucher's display name in chat.
Good example voucher ideas:
- $10,000 Money Voucher
- 30 Level XP Voucher
- Supply Crate Key Voucher
- Rank Trial Voucher
- Seasonal Reward Voucher
Why this is useful:
- Great for crates
- Great for events
- Great for staff rewards
- Great for webstore delivery
- Great for limited-time seasonal content
- id: "config-files"
title: "Config Files"
icon: "BOOK_AND_QUILL"
content: |
config.yml
Main settings file. Controls enabled modules, combat rules, displays, generators, boosters, pouches, collectors, vault defaults, and more.
shop.yml
Shop categories, item pricing, and sell values.
crates.yml
Standard crates, keys, placed crate behavior, monthly rewards, holograms, sounds, and reward pools.
enchants.yml
Custom enchant definitions, weights, item restrictions, and effect settings.
mobs.yml
Custom mob drops and mob-related configuration.
vouchers.yml
Saved voucher definitions created by admins.
data.db
SQLite storage used for persisted runtime data such as boosters.
- id: "admin-dashboard"
title: "Admin Dashboard"
icon: "NETHER_STAR"
content: |
/settings opens the main administration dashboard.
What it helps with:
- Quick navigation to major systems
- Module toggles
- Feature shortcuts
- Health checks
- Reload access
- Status visibility
The dashboard is made for fast server management, while detailed values still live in the proper config files where they are easier to maintain cleanly.
- id: "compatibility"
title: "Compatibility"
icon: "BEACON"
content: |
Compatibility target:
- Java 8 bytecode
- Spigot 1.8.8 style API surface
- Intended to remain loadable on newer Bukkit-compatible servers
Real-world note:
No large gameplay plugin can guarantee identical behavior on every single fork, plugin stack, placeholder set, vanish stack, or protection setup from 1.8 through latest.
You should always test:
- Combat tagging
- Scoreboard formatting
- Generator behavior
- Economy payouts
- Collectors
- Crates
- Essentials integration
- Placeholder output
- id: "faq"
title: "FAQ"
icon: "COMPASS"
content: |
Q: Do I need Vault?
A: You need Vault for economy-backed systems like money pouches, boosters, shop payouts, and generator purchases.
Q: Do I need EssentialsX?
A: Only if you want the kit and warp GUI features.
Q: Can I disable features I do not want?
A: Yes. The plugin is modular and major systems can be disabled.
Q: Can owners edit most things?
A: Yes. The project was designed to give owners a lot of control through config files, commands, and admin menus.
Q: Are special items protected from fake copies?
A: Yes. High-value plugin items are signed.
Q: Can this replace several plugins at once?
A: Yes, that is one of the main goals of the project.
- id: "support"
title: "Support Notes"
icon: "FEATHER"
content: |
Before asking for support, please check:
- Vault is installed if you use money features
- EssentialsX is installed if you use kits and warps
- Your economy plugin is actually hooked into Vault
- Placeholder names are correct for your server
- Your scoreboard lines are short enough for 1.8 clients
- You reloaded or restarted after config edits
Best support information to provide:
- Server version
- Plugin version
- Full error message
- What command or action caused the issue
- Which optional plugins are installed
marketing:
short-description: "A premium all-in-one factions essentials suite with crates, boosters, collectors, vouchers, enchants, displays, shop, generators, and admin tools."
feature-callouts:
- "Animated MOTD, tab, and scoreboard examples included"
- "Advanced crates with holograms, preview support, sounds, and monthly vouchers"
- "Directional generator buckets for factions economies"
- "Collectors, custom mob drops, and sell integration"
- "Custom enchants, pouches, vouchers, and boosters"
- "Modular design with in-game admin controls"
keywords:
- "factions"
- "essentials"
- "crates"
- "boosters"
- "collectors"
- "custom enchants"
- "generator buckets"
- "shop"
- "voucher"
- "scoreboard"
editor-notes:
purpose: "This file is written as a reusable documentation source for a BuiltByBit resource page, wiki system, or internal documentation export."
tips:
- "Replace example IPs, links, and branding with your real server identity before publishing."
- "If you sell this resource publicly, keep the Overview, Requirements, Installation, Commands, Permissions, and FAQ pages intact."
- "For a cleaner sales page, the marketing.short-description and marketing.feature-callouts can be reused directly."
