Set up utility commands, repair and player settings
Turn on /heal, /feed, /fly and friends, price /repair per rank, write join and leave messages, run commands on a timer and let players mute announcements in /settings.
You will have the everyday player commands working with permissions, a /repair that costs what you decide,
custom join and leave messages, commands that run on a timer, and a /settings screen where each player
mutes the announcements they do not want. Each part is its own module in config.yml
(Switch modules on and off): player-utils, repair, join-leave,
scheduled-commands and player-settings.
Player utilities#
Nine commands, one permission each, all under exyliasurvivalcore.playerutils.: /heal, /feed, /fly,
/hat, /craft (aliases /workbench, /wb), /anvil, /ec (alias /enderchest), /nightvision
(alias /nv) and /ping. Grant the node to the ranks that should have each one; the table at the end of
this page lists them all.
/heal and /feed cooldowns also come per rank: grant exyliasurvivalcore.playerutils.heal.cooldown.<seconds>
or .feed.cooldown.<seconds> and the lowest number a player holds wins over the setting. The cooldowns
survive a relog and a server switch.
/fly is taken away in combat and inside a protection under siege, and is given back afterwards. /heal is
refused in combat. /hat respects the blocked items list. Flight and night vision are remembered across
sessions.
Player utility settings (modules/player-utils/config.yml, under settings:)
| Setting | Default | What it does |
|---|---|---|
night-vision-amplifier | 0 | Strength of the /nightvision effect |
heal-cooldown-seconds | 0 | Cooldown of /heal |
feed-cooldown-seconds | 0 | Cooldown of /feed |
Repair#
/repair hand repairs what the player is holding; /repair all repairs everything they carry. /fix is an
alias. By default hand repair costs 75 with a 120 second cooldown, and repairing everything costs 200 with a
120 second cooldown, in the default currency.
Price repairs per rank#
Open the groups file
Edit modules/repair/groups.yml. It ships empty, with a commented vip example.
Add a group
groups:
vip:
hand: { price: 2500.0, cooldown-seconds: 60 }
all: { price: 5000.0, cooldown-seconds: 60 }Give the permission
A player in that group needs exyliasurvivalcore.repair.group.vip.
Reload
Run /survivalcoreadmin reload.
A player holding several groups gets, for each kind of repair, the cheapest one; the shorter cooldown breaks a tie. A group's price replaces the default rather than competing with it, so a group priced above the defaults makes its players pay more than everybody else.
/repair hand <player> and /repair all <player> repair somebody else, with
exyliasurvivalcore.repair.hand.others and .all.others; whoever runs the command pays and waits.
/repair lock and /repair unlock protect an item from being repaired.
exyliasurvivalcore.repair.bypass.price and .bypass.cooldown skip the two costs. Bare /repair prints the
usage line; there is no root form.
Repair settings (modules/repair/config.yml, under settings:)
| Setting | Default |
|---|---|
default-hand-price | 75.0 |
default-hand-cooldown | 120 (seconds) |
default-all-price | 200.0 |
default-all-cooldown | 120 (seconds) |
currency | empty, which means the default currency |
currency is any id from ExyliaLib's economy.yml, items and experience included. See
ExyliaLib economy.
Join and leave#
Chat lines, titles and action bars live in modules/join-leave/messages.yml: default-join,
default-quit and first-join. Sounds, commands and the on/off switch of each are in
modules/join-leave/config.yml. %player% and %count% (the join counter) work in the text.
Edit the default lines
Change default-join.chat, default-quit.chat and first-join.chat in messages.yml. A line is
coloured with ExyliaLib colours.
Add a rank version
In modules/join-leave/groups.yml, give a group a permission and a priority, plus its own
join and quit text. The shipped vip group has only the text: add permission: (for example
survivalcore.joinleave.vip) and priority: 10, or it never matches.
Reload
Run /survivalcoreadmin reload.
The highest priority group whose permission the player holds wins.
When ExyliaLobby is installed and enabled, this module stays off and ExyliaLobby handles join and leave
messages, along with jump pads and portals. Set defer-to-exylia-lobby: false in the plugin's config.yml
to keep this plugin's own versions, then restart. The spawn module is not affected.
Join and leave messages are one of the broadcasts a player can turn off in /settings.
Join and leave settings (modules/join-leave/config.yml)
settings:
counter-enabled: true
hide-vanilla-messages: true
default-join:
enabled: true
sound: "BLOCK_NOTE_BLOCK_PLING|0.6|1.4"
commands: []
default-quit:
enabled: true
sound: ""
commands: []
first-join:
enabled: true
sound: "BLOCK_NOTE_BLOCK_CHIME|0.7|1.2"
commands: []Commands take a console: or player: prefix. counter-enabled shows the player's join number on first
join, and hide-vanilla-messages replaces the vanilla lines with these.
Scheduled commands#
Console commands and broadcasts on a timer, from modules/scheduled-commands/config.yml.
sections:
resource_drop:
enabled: true
interval: 1800
network: false
per-player: false
commands: []
broadcast: "{highlight}[Event] {letters}A resource drop is happening now!"
daily_bonus:
enabled: false
interval: 86400
network: false
per-player: true
commands:
- "eco give %player_name% 50"
broadcast: "{success}Pay day! {letters}Everyone online gets {highlight}50{letters}."Section keys
| Key | What it does |
|---|---|
interval | Seconds between runs. The last run is remembered across restarts, and a new section first runs one full interval after it was added |
broadcast | Sent to everybody who has server event announcements on; leave it empty to announce nothing |
network | true runs the section once for the whole network, and its broadcast reaches the players of every server. false makes each server run it on its own |
per-player | true runs the commands once for every online player, filling %player_name% (or %player%). It turns itself on when a line uses %player_name%. With network: true that is every player on the server that ran it |
One failing command does not stop the rest of the section. The file is written once, when it is missing: nothing you add is pruned, nothing you delete comes back. Untouched examples from older releases are brought up to date.
Player settings#
/settings (aliases /preferences, /options, permission exyliasurvivalcore.settings) is a screen every
player owns, built on ExyliaLib's settings module. Fourteen switches decide what reaches them. Every one is
on by default, and a player turns off what they do not want.
| Setting | What it turns off |
|---|---|
| Death messages | The plugin's death broadcast |
| Join & leave | Join and leave messages, both directions |
| Rank ups | Somebody else ranking up |
| Purchases | Reclaim broadcasts |
| Missions | Somebody finishing a weekly mission |
| Boosters | A global booster starting or ending |
| Projects | A community project completing and the next one starting |
| Seasons | A season closing and who won it |
| Server events | What a scheduled command section broadcasts |
| Protection messages | Titles and greetings walking into and out of protections |
| Raid announcements | A protection raided, and siege windows opening and closing |
| Teleport requests | Whether they receive requests at all |
| Auto accept | Accept teleport requests without asking |
| Confirm before sending | The confirmation before sending a request |
Switches whose features live in another plugin (protections, for one) still show when that module is loaded.
A setting whose module is off reads as unavailable and does nothing. The three teleport rows are the tpa
module's own, so they are not stored twice.
The kill, bounty, crate, duel, market, auction, vote, trade and autosell switches left with their features.
Check that it works#
Run /settings, turn off Join & leave and have another player join: you should see no join line, while they
still do. Run /heal after granting exyliasurvivalcore.playerutils.heal.
Commands and permissions#
| Command | What it does | Permission |
|---|---|---|
/heal | Heals you, with its own cooldown | exyliasurvivalcore.playerutils.heal |
/feed | Fills your hunger, with its own cooldown | exyliasurvivalcore.playerutils.feed |
/fly | Toggles flight | exyliasurvivalcore.playerutils.fly |
/hat | Wears the item in your hand as a hat | exyliasurvivalcore.playerutils.hat |
/anvil | Opens an anvil | exyliasurvivalcore.playerutils.anvil |
/ping | Shows your ping | exyliasurvivalcore.playerutils.ping |
/craft | Opens a crafting table | exyliasurvivalcore.playerutils.craft |
/ec | Opens your ender chest | exyliasurvivalcore.playerutils.ec |
/nightvision | Toggles night vision | exyliasurvivalcore.playerutils.nightvision |
/repair | Prints the usage line | — |
/repair hand [player] | Repairs the item in your hand | exyliasurvivalcore.repair.hand |
/repair all [player] | Repairs everything you carry | exyliasurvivalcore.repair.all |
/repair lock | Protects the held item from repairs | exyliasurvivalcore.repair.lock |
/repair unlock | Lifts that protection | exyliasurvivalcore.repair.lock |
/settings | Opens your personal settings | exyliasurvivalcore.settings |
| Permission | Who has it | What it allows |
|---|---|---|
exyliasurvivalcore.settings | Everyone | `/settings` |
exyliasurvivalcore.repair.hand | Everyone | `/repair hand` |
exyliasurvivalcore.repair.all | Everyone | `/repair all` |
exyliasurvivalcore.repair.lock | Everyone | `/repair lock` and `unlock` |
exyliasurvivalcore.playerutils.ping | Everyone | `/ping` |
exyliasurvivalcore.playerutils.fly | Admins (op) | `/fly` |
exyliasurvivalcore.playerutils.heal | Admins (op) | `/heal` |
exyliasurvivalcore.playerutils.feed | Admins (op) | `/feed` |
exyliasurvivalcore.playerutils.nightvision | Admins (op) | `/nightvision` |
exyliasurvivalcore.playerutils.hat | Admins (op) | `/hat` |
exyliasurvivalcore.playerutils.ec | Admins (op) | `/ec` |
exyliasurvivalcore.playerutils.craft | Admins (op) | `/craft` |
exyliasurvivalcore.playerutils.anvil | Admins (op) | `/anvil` |
exyliasurvivalcore.repair.hand.others | Admins (op) | Repairing another player's held item |
exyliasurvivalcore.repair.all.others | Admins (op) | Repairing another player's inventory |
exyliasurvivalcore.repair.bypass.price | Admins (op) | The repair price |
exyliasurvivalcore.repair.bypass.cooldown | Admins (op) | The repair cooldown |
exyliasurvivalcore.enchantments.bypass | Admins (op) | The enchantment limits |
| Placeholder | Shows | Example |
|---|---|---|
%exyliasurvivalcore_settings_death_messages% | Whether other players' death messages reach them | — |
%exyliasurvivalcore_settings_join_leave_messages% | Whether join and leave broadcasts reach them | — |
%exyliasurvivalcore_settings_rankup_announcements% | Whether somebody reaching a new rank is announced to them | — |
%exyliasurvivalcore_settings_purchase_announcements% | Whether somebody claiming a purchase is announced to them | — |
%exyliasurvivalcore_settings_mission_announcements% | Whether mission announcements reach them | — |
%exyliasurvivalcore_settings_booster_announcements% | Whether booster announcements reach them | — |
%exyliasurvivalcore_settings_project_announcements% | Whether community project announcements reach them | — |
%exyliasurvivalcore_settings_season_announcements% | Whether season announcements reach them | — |
%exyliasurvivalcore_settings_scheduled_announcements% | Whether scheduled command announcements reach them | — |
%exyliasurvivalcore_settings_tpa_requests% | Whether teleport requests reach them | — |
%exyliasurvivalcore_settings_tpa_auto_accept% | Whether a request is accepted without asking | — |
%exyliasurvivalcore_settings_tpa_confirm% | Whether sending a request asks for a confirmation | — |
%exyliasurvivalcore_settings_protection_messages% | Protection messages; only applies when ExyliaProtections is installed | — |
%exyliasurvivalcore_settings_raid_announcements% | Raid announcements; only applies when ExyliaProtections is installed | — |
Something missing on this page? Tell us on Discord