YAML:
# =========================================================
# AstroRelics by AstroDev
#
# Plugin is in english veriosn Plug&Play. For polish customers: just
# replace files config.yml and lang.yml from pl_PL with main files.
#
# This file controls:
# - relic effect timing
# - relic sell protection
# - GUI appearance and size
# - all relic definitions
#
# Useful commands:
# - /relic gui
# - /relic give PLAYER RELIC_ID
# - /relic reload
# - /relic help
# - /relic patricles TRUE/FALSE
#
# Important:
# - use /relic reload after every change
# - YAML is indentation-sensitive, use spaces instead of tabs
# - the easiest way to add a new relic is to copy an existing entry
# =========================================================
effects:
# ==================================
# EFFECT SETTINGS
# ==================================
# interval:
# How often the plugin checks whether a player is holding a relic.
# 20 ticks = 1 second.
interval: 10
# duration:
# How long a single effect application lasts.
# Keep this value higher than interval so the effect does not flicker.
duration: 40
# remove-immediately:
# true = effect disappears immediately after removing the relic
# false = effect expires naturally after duration
remove-immediately: true
# ===============================
# RELIC SELL PROTECTION
# ===============================
sell:
# Commands listed here are treated as sell commands by the plugin.
# Relics are temporarily removed from the inventory so they cannot be sold,
# then returned to the player right after the command is processed.
commands:
# Write commands without the leading "/"
- "sellall"
- "sellall inventory"
- "sell"
- "sell hand"
# ===============================
# GUI SETTINGS
# ===============================
settings:
gui:
# GUI title shown to the player.
title: "&6&lʀᴇʟɪᴄꜱ"
# GUI size must be a multiple of 9.
# 36 = 4 rows.
# Empty slots are automatically filled with filler panes.
size: 36
# ===============================
# RELIC DEFINITIONS
# ===============================
relics:
# Each relic uses the same structure:
# - enabled: turns the relic on or off
# - slot: GUI position
# - material: base Minecraft item
# - custom-model-data: resource pack model id
# - name: player-facing display name
# - lore: item description, one line per "-"
# - effects: potion effects granted to the player
# - particles: visual effect around the player
#
# With size: 36, valid slots are 0-35.
# Effect amplifier levels:
# 0 = I
# 1 = II
# 2 = III
leaper:
enabled: true
slot: 11
item:
material: RABBIT_FOOT
custom-model-data: 2001
name: "&d&lʟᴇᴀᴘᴇʀ ʀᴇʟɪᴄ"
lore:
- ""
- "&fʜᴏʟᴅ ɪᴛ ɪɴ ʏᴏᴜʀ ʜᴀɴᴅ"
- "&fᴛᴏ ɢᴀɪɴ ᴀ ʙᴏɴᴜꜱ"
- ""
- "&aᴊᴜᴍᴘ ɪɪɪ"
- "&bꜱᴘᴇᴇᴅ ɪɪ"
effects:
- type: JUMP
amplifier: 2
- type: SPEED
amplifier: 1
particles:
enabled: true
type: CLOUD
count: 10
offset:
x: 0.3
y: 0.5
z: 0.3
miner:
enabled: true
slot: 12
item:
material: COAL
custom-model-data: 2002
name: "&d&lᴍɪɴᴇʀ ʀᴇʟɪᴄ"
lore:
- ""
- "&fʜᴏʟᴅ ɪᴛ ɪɴ ʏᴏᴜʀ ʜᴀɴᴅ"
- "&fᴛᴏ ɢᴀɪɴ ᴀ ʙᴏɴᴜꜱ"
- ""
- "&aʜᴀꜱᴛᴇ ɪɪ"
effects:
- type: HASTE
amplifier: 1
particles:
enabled: true
type: END_ROD
count: 10
offset:
x: 0.3
y: 0.5
z: 0.3
blaze:
enabled: true
slot: 13
item:
material: BLAZE_ROD
custom-model-data: 2003
name: "&d&lʙʟᴀᴢᴇ ʀᴇʟɪᴄ"
lore:
- ""
- "&fʜᴏʟᴅ ɪᴛ ɪɴ ʏᴏᴜʀ ʜᴀɴᴅ"
- "&fᴛᴏ ɢᴀɪɴ ᴀ ʙᴏɴᴜꜱ"
- ""
- "&aꜰɪʀᴇ ʀᴇꜱɪꜱᴛᴀɴᴄᴇ"
effects:
- type: FIRE_RESISTANCE
amplifier: 0
particles:
enabled: true
type: LAVA
count: 10
offset:
x: 0.3
y: 0.5
z: 0.3
diver:
enabled: true
slot: 14
item:
material: HEART_OF_THE_SEA
custom-model-data: 2004
name: "&d&lᴅɪᴠᴇʀ ʀᴇʟɪᴄ"
lore:
- ""
- "&fʜᴏʟᴅ ɪᴛ ɪɴ ʏᴏᴜʀ ʜᴀɴᴅ"
- "&fᴛᴏ ɢᴀɪɴ ᴀ ʙᴏɴᴜꜱ"
- ""
- "&bᴡᴀᴛᴇʀ ʙʀᴇᴀᴛʜɪɴɢ"
effects:
- type: WATER_BREATHING
amplifier: 0
particles:
enabled: true
type: BUBBLE
count: 10
offset:
x: 0.3
y: 0.5
z: 0.3
night:
enabled: true
slot: 15
item:
material: AMETHYST_SHARD
custom-model-data: 2005
name: "&d&lɴɪɢʜᴛ ʀᴇʟɪᴄ"
lore:
- ""
- "&fʜᴏʟᴅ ɪᴛ ɪɴ ʏᴏᴜʀ ʜᴀɴᴅ"
- "&fᴛᴏ ɢᴀɪɴ ᴀ ʙᴏɴᴜꜱ"
- ""
- "&aɴɪɢʜᴛ ᴠɪꜱɪᴏɴ"
effects:
- type: NIGHT_VISION
amplifier: 0
particles:
enabled: true
type: WAX_OFF
count: 8
offset:
x: 0.25
y: 0.4
z: 0.25
angel:
enabled: true
slot: 16
item:
material: FEATHER
custom-model-data: 2006
name: "&d&lᴀɴɢᴇʟ ʀᴇʟɪᴄ"
lore:
- ""
- "&fʜᴏʟᴅ ɪᴛ ɪɴ ʏᴏᴜʀ ʜᴀɴᴅ"
- "&fᴛᴏ ɢᴀɪɴ ᴀ ʙᴏɴᴜꜱ"
- ""
- "&fꜱʟᴏᴡ ꜰᴀʟʟɪɴɢ"
effects:
- type: SLOW_FALLING
amplifier: 0
particles:
enabled: true
type: CLOUD
count: 8
offset:
x: 0.25
y: 0.45
z: 0.25
warrior:
enabled: true
slot: 17
item:
material: FLINT
custom-model-data: 2007
name: "&d&lᴡᴀʀʀɪᴏʀ ʀᴇʟɪᴄ"
lore:
- ""
- "&fʜᴏʟᴅ ɪᴛ ɪɴ ʏᴏᴜʀ ʜᴀɴᴅ"
- "&fᴛᴏ ɢᴀɪɴ ᴀ ʙᴏɴᴜꜱ"
- ""
- "&cꜱᴛʀᴇɴɢᴛʜ ɪɪ"
effects:
- type: STRENGTH
amplifier: 1
particles:
enabled: true
type: CRIT
count: 10
offset:
x: 0.3
y: 0.5
z: 0.3
shadow:
enabled: true
slot: 9
item:
material: FERMENTED_SPIDER_EYE
custom-model-data: 2008
name: "&d&lꜱʜᴀᴅᴏᴡ ʀᴇʟɪᴄ"
lore:
- ""
- "&fʜᴏʟᴅ ɪᴛ ɪɴ ʏᴏᴜʀ ʜᴀɴᴅ"
- "&fᴛᴏ ɢᴀɪɴ ᴀ ʙᴏɴᴜꜱ"
- ""
- "&8ɪɴᴠɪꜱɪʙɪʟɪᴛʏ"
effects:
- type: INVISIBILITY
amplifier: 0
particles:
enabled: true
type: SMOKE
count: 8
offset:
x: 0.25
y: 0.4
z: 0.25
life:
enabled: true
slot: 10
item:
material: GHAST_TEAR
custom-model-data: 2009
name: "&d&lʟɪꜰᴇ ʀᴇʟɪᴄ"
lore:
- ""
- "&fʜᴏʟᴅ ɪᴛ ɪɴ ʏᴏᴜʀ ʜᴀɴᴅ"
- "&fᴛᴏ ɢᴀɪɴ ᴀ ʙᴏɴᴜꜱ"
- ""
- "&6ᴀʙꜱᴏʀᴘᴛɪᴏɴ"
effects:
- type: ABSORPTION
amplifier: 0
particles:
enabled: true
type: TOTEM_OF_UNDYING
count: 8
offset:
x: 0.3
y: 0.5
z: 0.3
renewal:
enabled: true
slot: 18
item:
material: GLISTERING_MELON_SLICE
custom-model-data: 2010
name: "&d&lʀᴇɴᴇᴡᴀʟ ʀᴇʟɪᴄ"
lore:
- ""
- "&fʜᴏʟᴅ ɪᴛ ɪɴ ʏᴏᴜʀ ʜᴀɴᴅ"
- "&fᴛᴏ ɢᴀɪɴ ᴀ ʙᴏɴᴜꜱ"
- ""
- "&dʀᴇɢᴇɴᴇʀᴀᴛɪᴏɴ ɪ"
effects:
- type: REGENERATION
amplifier: 0
particles:
enabled: true
type: HEART
count: 8
offset:
x: 0.25
y: 0.45
z: 0.25
fortune:
enabled: true
slot: 19
item:
material: EMERALD
custom-model-data: 2011
name: "&d&lꜰᴏʀᴛᴜɴᴇ ʀᴇʟɪᴄ"
lore:
- ""
- "&fʜᴏʟᴅ ɪᴛ ɪɴ ʏᴏᴜʀ ʜᴀɴᴅ"
- "&fᴛᴏ ɢᴀɪɴ ᴀ ʙᴏɴᴜꜱ"
- ""
- "&aʟᴜᴄᴋ"
effects:
- type: LUCK
amplifier: 0
particles:
enabled: true
type: HAPPY_VILLAGER
count: 8
offset:
x: 0.3
y: 0.45
z: 0.3
ocean:
enabled: true
slot: 20
item:
material: PRISMARINE_CRYSTALS
custom-model-data: 2012
name: "&d&lᴏᴄᴇᴀɴ ʀᴇʟɪᴄ"
lore:
- ""
- "&fʜᴏʟᴅ ɪᴛ ɪɴ ʏᴏᴜʀ ʜᴀɴᴅ"
- "&fᴛᴏ ɢᴀɪɴ ᴀ ʙᴏɴᴜꜱ"
- ""
- "&bᴅᴏʟᴘʜɪɴ'ꜱ ɢʀᴀᴄᴇ"
effects:
- type: DOLPHINS_GRACE
amplifier: 0
particles:
enabled: true
type: SPLASH
count: 10
offset:
x: 0.3
y: 0.5
z: 0.3
depths:
enabled: true
slot: 21
item:
material: NAUTILUS_SHELL
custom-model-data: 2013
name: "&d&lᴅᴇᴘᴛʜꜱ ʀᴇʟɪᴄ"
lore:
- ""
- "&fʜᴏʟᴅ ɪᴛ ɪɴ ʏᴏᴜʀ ʜᴀɴᴅ"
- "&fᴛᴏ ɢᴀɪɴ ᴀ ʙᴏɴᴜꜱ"
- ""
- "&3ᴄᴏɴᴅᴜɪᴛ ᴘᴏᴡᴇʀ"
effects:
- type: CONDUIT_POWER
amplifier: 0
particles:
enabled: true
type: BUBBLE
count: 10
offset:
x: 0.3
y: 0.5
z: 0.3
titan:
enabled: true
slot: 22
item:
material: IRON_INGOT
custom-model-data: 2014
name: "&d&lᴛɪᴛᴀɴ ʀᴇʟɪᴄ"
lore:
- ""
- "&fʜᴏʟᴅ ɪᴛ ɪɴ ʏᴏᴜʀ ʜᴀɴᴅ"
- "&fᴛᴏ ɢᴀɪɴ ᴀ ʙᴏɴᴜꜱ"
- ""
- "&6ʜᴇᴀʟᴛʜ ʙᴏᴏꜱᴛ ɪɪ"
effects:
- type: HEALTH_BOOST
amplifier: 1
particles:
enabled: true
type: GLOW
count: 8
offset:
x: 0.25
y: 0.45
z: 0.25
defender:
enabled: true
slot: 23
item:
material: SHIELD
custom-model-data: 2015
name: "&d&lᴅᴇꜰᴇɴᴅᴇʀ ʀᴇʟɪᴄ"
lore:
- ""
- "&fʜᴏʟᴅ ɪᴛ ɪɴ ʏᴏᴜʀ ʜᴀɴᴅ"
- "&fᴛᴏ ɢᴀɪɴ ᴀ ʙᴏɴᴜꜱ"
- ""
- "&9ʀᴇꜱɪꜱᴛᴀɴᴄᴇ ɪ"
effects:
- type: RESISTANCE
amplifier: 0
particles:
enabled: true
type: WAX_ON
count: 8
offset:
x: 0.25
y: 0.4
z: 0.25
dawn:
enabled: true
slot: 24
item:
material: GLOWSTONE_DUST
custom-model-data: 2016
name: "&d&lᴅᴀᴡɴ ʀᴇʟɪᴄ"
lore:
- ""
- "&fʜᴏʟᴅ ɪᴛ ɪɴ ʏᴏᴜʀ ʜᴀɴᴅ"
- "&fᴛᴏ ɢᴀɪɴ ᴀ ʙᴏɴᴜꜱ"
- ""
- "&eꜱᴀᴛᴜʀᴀᴛɪᴏɴ"
effects:
- type: SATURATION
amplifier: 0
particles:
enabled: true
type: WAX_OFF
count: 8
offset:
x: 0.25
y: 0.4
z: 0.25
scout:
enabled: true
slot: 25
item:
material: SPYGLASS
custom-model-data: 2017
name: "&d&lꜱᴄᴏᴜᴛ ʀᴇʟɪᴄ"
lore:
- ""
- "&fʜᴏʟᴅ ɪᴛ ɪɴ ʏᴏᴜʀ ʜᴀɴᴅ"
- "&fᴛᴏ ɢᴀɪɴ ᴀ ʙᴏɴᴜꜱ"
- ""
- "&bꜱᴘᴇᴇᴅ ɪ"
- "&aɴɪɢʜᴛ ᴠɪꜱɪᴏɴ"
effects:
- type: SPEED
amplifier: 0
- type: NIGHT_VISION
amplifier: 0
particles:
enabled: true
type: GLOW
count: 8
offset:
x: 0.25
y: 0.45
z: 0.25
mage:
enabled: true
slot: 26
item:
material: BOOK
custom-model-data: 2018
name: "&d&lꜱᴀɢᴇ ʀᴇʟɪᴄ"
lore:
- ""
- "&fʜᴏʟᴅ ɪᴛ ɪɴ ʏᴏᴜʀ ʜᴀɴᴅ"
- "&fᴛᴏ ɢᴀɪɴ ᴀ ʙᴏɴᴜꜱ"
- ""
- "&aʜᴀꜱᴛᴇ ɪ"
- "&6ʟᴜᴄᴋ"
effects:
- type: HASTE
amplifier: 0
- type: LUCK
amplifier: 0
particles:
enabled: true
type: ENCHANT
count: 10
offset:
x: 0.3
y: 0.5
z: 0.3
YAML:
messages:
no-permission: "&b&lᴀꜱᴛʀᴏ ʀᴇʟɪᴄꜱ&r &cʏᴏᴜ ᴅᴏ ɴᴏᴛ ʜᴀᴠᴇ ᴘᴇʀᴍɪꜱꜱɪᴏɴ!"
player-not-found: "&b&lᴀꜱᴛʀᴏ ʀᴇʟɪᴄꜱ&r &cᴘʟᴀʏᴇʀ ɴᴏᴛ ꜰᴏᴜɴᴅ!"
unknown-relic: "&b&lᴀꜱᴛʀᴏ ʀᴇʟɪᴄꜱ&r &cᴜɴᴋɴᴏᴡɴ ʀᴇʟɪᴄ!"
relic-received: "&b&lᴀꜱᴛʀᴏ ʀᴇʟɪᴄꜱ&r &aʏᴏᴜ ʀᴇᴄᴇɪᴠᴇᴅ ᴀ ʀᴇʟɪᴄ"
relic-given: "&b&lᴀꜱᴛʀᴏ ʀᴇʟɪᴄꜱ&r &aʀᴇʟɪᴄ ɢɪᴠᴇɴ ᴛᴏ ᴛʜᴇ ᴘʟᴀʏᴇʀ"
config-reloaded: "&b&lᴀꜱᴛʀᴏ ʀᴇʟɪᴄꜱ&r &aᴄᴏɴꜰɪɢ ʀᴇʟᴏᴀᴅᴇᴅ!"
usage-main: "&b&lᴀꜱᴛʀᴏ ʀᴇʟɪᴄꜱ&r &c/ʀᴇʟɪᴄ ɢᴜɪ | ɢɪᴠᴇ | ʀᴇʟᴏᴀᴅ | ᴘᴀʀᴛɪᴄʟᴇꜱ"
help:
- "&6&lᴄᴏᴍᴍᴀɴᴅꜱ:"
- ""
- "&e/ʀᴇʟɪᴄ ɢᴜɪ &7- &fᴏᴘᴇɴꜱ ᴛʜᴇ ɢᴜɪ"
- "&e/ʀᴇʟɪᴄ ɢɪᴠᴇ <ᴘʟᴀʏᴇʀ> <ʀᴇʟɪᴄ> &7- &fɢɪᴠᴇꜱ ᴀ ʀᴇʟɪᴄ"
- "&e/ʀᴇʟɪᴄ ʀᴇʟᴏᴀᴅ &7- &fʀᴇʟᴏᴀᴅꜱ ᴛʜᴇ ᴄᴏɴꜰɪɢ"
- "&e/ʀᴇʟɪᴄ ᴘᴀʀᴛɪᴄʟᴇꜱ ᴛʀᴜᴇ/ꜰᴀʟꜱᴇ &7- &fᴛᴏɢɢʟᴇꜱ ᴘᴀʀᴛɪᴄʟᴇꜱ"
particles:
enabled: "&b&lᴀꜱᴛʀᴏ ʀᴇʟɪᴄꜱ&r &aᴘᴀʀᴛɪᴄʟᴇꜱ ᴇɴᴀʙʟᴇᴅ!"
disabled: "&b&lᴀꜱᴛʀᴏ ʀᴇʟɪᴄꜱ&r &cᴘᴀʀᴛɪᴄʟᴇꜱ ᴅɪꜱᴀʙʟᴇᴅ!"
usage: "&b&lᴀꜱᴛʀᴏ ʀᴇʟɪᴄꜱ&r &c/ʀᴇʟɪᴄ ᴘᴀʀᴛɪᴄʟᴇꜱ ᴛʀᴜᴇ/ꜰᴀʟꜱᴇ"
only-player: "&b&lᴀꜱᴛʀᴏ ʀᴇʟɪᴄꜱ&r &cᴛʜɪꜱ ᴄᴏᴍᴍᴀɴᴅ ɪꜱ ꜰᴏʀ ᴘʟᴀʏᴇʀꜱ ᴏɴʟʏ!"
AstroRelics
Advanced relic system for Paper 1.21+
AstroRelics is a powerful Minecraft Paper plugin that adds a complete relic system to your server.
It comes with 18 ready-to-use relics, each with its own item, effects, particles, and GUI slot configuration.
The plugin is built to be simple for players, easy to manage for administrators, and flexible enough to expand for custom server ideas.
What AstroRelics adds to your server
AstroRelics introduces special relic items that grant bonuses only while the player is holding them.This makes the system clear, balanced, and easy to understand during normal gameplay.
Each relic can have its own:
material
custom name
lore
potion effects- particles
GUI slot
balance settings
Survival progression
SkyBlock rewards
PvP and PvE bonuses
event prizes
dungeon loot
rare collectibles
server shops
custom gameplay systems
Core Features
18 unique relics included
The plugin already comes with 18 configured relics, ready to use right after installation.
Held-item effects
Relic effects only work when the player is actually holding the item in their hand.
Configurable GUI
AstroRelics includes a relic menu GUI with configurable size, title, and slots. Particle system
Each relic can display its own particles for extra atmosphere and visual identity.
Sell protection
Relics can be protected from accidental selling through commands like:- /sell
- /sellall
- /sellall inventory
- and similar shop actions
Easy balancing
All important relic values can be adjusted in the config, making balancing fast and simple.
Administrator commands
The plugin includes practical commands for managing relics and reloading the configuration.
Paper 1.21+ support
Built specifically for Paper 1.21+ with focus on low resource usage and stable performance. Included relics
AstroRelics includes 18 ready relics, such as:
Jumper Relic – Jump III + Speed II
Miner Relic – Haste II- Blaze Relic – Fire Resistance
Diver Relic – Water Breathing
Night Relic – Night Vision
Angel Relic – Slow Falling- Warrior Relic – Strength II
Shadow Relic – Invisibility
Life Relic – Absorption
Renewal Relic – Regeneration I
Fortune Relic – Luck I
Ocean Relic – Dolphin’s Grace
Depths Relic – Conduit Power- Titan Relic – Health Boost II
- Defender Relic – Resistance I
Dawn Relic – Saturation
Scout Relic – Speed I + Night Vision
Sage Relic – Haste I + Luck I
Plugin Systems
AstroRelics is more than just a few special items.It includes a full support system visible directly in the configuration.
Included systems:
- configurable relic GUI
- administrator command system
- relic particle system
- sell blocking
- effect balancing
easy expansion for new relics
- item
- effects
- particles
- GUI slot
- display settings
Commands
Player / Admin Commands
How it works
The player holds a relic
The plugin detects the configured relic item in the player’s hand.
The bonus is applied
The configured potion effects are instantly activated.
Particles are displayed
If enabled, the relic emits its own configured particles.
The player puts it away
The effect disappears after the relic leaves the hand.Because of this, the system feels natural and does not require complicated mechanics for players to understand it.
Why choose AstroRelics
AstroRelics is ideal for server owners who want to add something that feels:- unique
- useful
- configurable
professional
easy to expand
Perfect for
- Survival servers
- SkyBlock servers
RPG servers- PvE servers
- PvP servers
- event servers
- dungeon systems
loot and reward systems
Hype
Give your server items that actually feel special.AstroRelics adds a full relic system with 18 unique relics, custom effects, particles, GUI support, and protection against accidental selling.
Built for Paper 1.21+, easy to configure, easy to expand, and perfect for making your server stand out.
Perfect for Survival, SkyBlock, PvP, PvE, dungeons, events, and custom progression systems. You can add them into your ItemShop and boost sales!
