Content generated with AI — it may contain mistakes.

ExyliaArrows/Getting startedUpdated in v1.7.1

Introduction

ExyliaArrows gives your players 120 arrow effects. What it does, what you need and what you will have in ten minutes.

Page 1 of 224 min read

ExyliaArrows makes every shot look like something: a flash when the arrow leaves the bow, a trail along its flight and an impact where it lands. You get 120 ready-made effects in six categories, and you decide how players get them: from a menu, from a token on their bow, from a crate or from a shop.

In about ten minutes a player of yours will wear an effect and you will have seen all three moments in game. Start with Your first effect.

What you get#

  • 120 effects, twenty per category. Ember (ember, fire and forge work), Frost (frost, ice and snow), Storm (storm, wind and lightning), Void (void, sculk and souls), Prism (prism, crystal and starlight) and Goofy (goofy, rubber chickens and a sad trumpet). The list is in Add and edit effects.
  • Real objects, not only particles. Effects are built from blocks and items that turn, fall and grow, drawn by each player's own client, with particles around them for light.
  • Three moments per effect. Launch (the shot leaving the bow), trail (the flight) and impact (the landing, which can differ for a player and a block).
  • Two menus. The classic inventory menu, and the 3D selector that stands in the world and plays each effect in front of the player before they wear it.
  • A crate and a shop. Keys open a crate with odds by rarity, and locked effects can be bought with money. See Set up the crate and the shop.

Three ways players own an effect#

WayWhose it isSuits
The menuThe player's. They pick one in /arrows and it plays on whatever they shoot.Practice, PvP
A bowThe bow's. A token is dropped onto a bow and travels with it through chests, trades and deaths.Survival, economy
The crate or the shopTheirs for good. A key opens the crate, or a locked effect is bought from the menu. It is saved on the player, not rented with a rank.Any server with keys or money

behaviour.mode in config.yml picks whether the menu choice, the bow, or both are read. The default is both. See Bind effects to bows.

Before you start#

You needDetail
ServerPaper. The plugin declares api-version: '1.21' and is built against Paper 1.21.4. Folia is supported (folia-supported: true).
packeteventsRequired. The plugin does not load without it.
ExyliaLibThe loader installs it on the first start if it is missing. See Install ExyliaArrows.
OptionalPlaceholderAPI for placeholders, ExyliaEconomy or Vault for the shop, WorldGuard for the arrows-effects flag.
Players' clientsThe 3D selector and the 3D crate opening need a 1.21.4 client. Older clients (for example through ViaBackwards) get the inventory menus.
Minimum server version

The build files do not state a lowest tested Paper or Folia version. The plugin loads on servers that accept api-version: '1.21', and it is compiled against 1.21.4. If you run something older than 1.21.4, test it before you sell effects.

Going further#

  • Which projectiles carry an effect. By default arrows, spectral arrows and tridents. projectiles.all-types in config.yml extends it to every launched projectile, and one effect can name projectiles of its own.
  • Who sees what. Each player chooses what they see with the Particle visibility button: everyone's effects, nobody's, only their own or only other people's.
  • Write your own. Add effects to effects.yml by hand or with an AI assistant.
Technical details

Every effect declares up to five triggers in effects.yml:

TriggerWhen it playsWhat it can afford
launchThe shot leaving the bow.One short, quiet flash. Optional.
trailAlong the flight, every trail-interval ticks.One or two small displays plus a particle line. No sound. This is the one with a budget.
hitWherever it lands.The payoff: under a second, a dozen displays at most.
hit-entityOnly when it lands on something alive.Falls back to hit when not declared.
hit-blockOnly when it lands on a block.Falls back to hit when not declared.

An arrow lives about forty ticks, so a trail is drawn on every one of those ticks for every shot. Launch, trail and impact are compiled apart for that reason.

Visibility modes are stored as ALL, NONE, SELF_ONLY and OTHERS_ONLY. The player's choice, visibility and favourites live in one table in the plugin's database; keys and unlocks live in ExyliaLib's crate table.

Something missing on this page? Tell us on Discord