Content generated with AI — it may contain mistakes.

ExyliaSurvivalCore/GuidesUpdated in v1.2.2

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.

Page 14 of 387 min read

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:)
SettingDefaultWhat it does
night-vision-amplifier0Strength of the /nightvision effect
heal-cooldown-seconds0Cooldown of /heal
feed-cooldown-seconds0Cooldown 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

yaml
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.

The cheapest group wins

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:)
SettingDefault
default-hand-price75.0
default-hand-cooldown120 (seconds)
default-all-price200.0
default-all-cooldown120 (seconds)
currencyempty, 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.

ExyliaLobby takes over

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)
yaml
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.

yaml
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
KeyWhat it does
intervalSeconds between runs. The last run is remembered across restarts, and a new section first runs one full interval after it was added
broadcastSent to everybody who has server event announcements on; leave it empty to announce nothing
networktrue 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-playertrue 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.

SettingWhat it turns off
Death messagesThe plugin's death broadcast
Join & leaveJoin and leave messages, both directions
Rank upsSomebody else ranking up
PurchasesReclaim broadcasts
MissionsSomebody finishing a weekly mission
BoostersA global booster starting or ending
ProjectsA community project completing and the next one starting
SeasonsA season closing and who won it
Server eventsWhat a scheduled command section broadcasts
Protection messagesTitles and greetings walking into and out of protections
Raid announcementsA protection raided, and siege windows opening and closing
Teleport requestsWhether they receive requests at all
Auto acceptAccept teleport requests without asking
Confirm before sendingThe 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.

Moved switches

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#

CommandWhat it doesPermission
/healHeals you, with its own cooldownexyliasurvivalcore.playerutils.heal
/feedFills your hunger, with its own cooldownexyliasurvivalcore.playerutils.feed
/flyToggles flightexyliasurvivalcore.playerutils.fly
/hatWears the item in your hand as a hatexyliasurvivalcore.playerutils.hat
/anvilOpens an anvilexyliasurvivalcore.playerutils.anvil
/pingShows your pingexyliasurvivalcore.playerutils.ping
/craftOpens a crafting tableexyliasurvivalcore.playerutils.craft
/ecOpens your ender chestexyliasurvivalcore.playerutils.ec
/nightvisionToggles night visionexyliasurvivalcore.playerutils.nightvision
/repairPrints the usage line—
/repair hand [player]Repairs the item in your handexyliasurvivalcore.repair.hand
/repair all [player]Repairs everything you carryexyliasurvivalcore.repair.all
/repair lockProtects the held item from repairsexyliasurvivalcore.repair.lock
/repair unlockLifts that protectionexyliasurvivalcore.repair.lock
/settingsOpens your personal settingsexyliasurvivalcore.settings
PermissionWho has itWhat it allows
exyliasurvivalcore.settingsEveryone`/settings`
exyliasurvivalcore.repair.handEveryone`/repair hand`
exyliasurvivalcore.repair.allEveryone`/repair all`
exyliasurvivalcore.repair.lockEveryone`/repair lock` and `unlock`
exyliasurvivalcore.playerutils.pingEveryone`/ping`
exyliasurvivalcore.playerutils.flyAdmins (op)`/fly`
exyliasurvivalcore.playerutils.healAdmins (op)`/heal`
exyliasurvivalcore.playerutils.feedAdmins (op)`/feed`
exyliasurvivalcore.playerutils.nightvisionAdmins (op)`/nightvision`
exyliasurvivalcore.playerutils.hatAdmins (op)`/hat`
exyliasurvivalcore.playerutils.ecAdmins (op)`/ec`
exyliasurvivalcore.playerutils.craftAdmins (op)`/craft`
exyliasurvivalcore.playerutils.anvilAdmins (op)`/anvil`
exyliasurvivalcore.repair.hand.othersAdmins (op)Repairing another player's held item
exyliasurvivalcore.repair.all.othersAdmins (op)Repairing another player's inventory
exyliasurvivalcore.repair.bypass.priceAdmins (op)The repair price
exyliasurvivalcore.repair.bypass.cooldownAdmins (op)The repair cooldown
exyliasurvivalcore.enchantments.bypassAdmins (op)The enchantment limits
PlaceholderShowsExample
%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