VtAlters is a powerful tool suitable for creating a place where players can summon bosses on their own.
With VtAlters, you can create an altar, and players simply need to place the correct items you’ve predefined onto the pedestals and use the summoning item to activate the ritual. The boss will be summoned in a straightforward manner, with simple commands and functions that make it easy for you to get started and create your own custom altar.
/vta reload (Reload all configs and alters) /vta list (View the list of existing altars)
#================================#
# General Settings #
#================================#
# Set the language file for plugin messages.
# This corresponds to the file in the 'language' folder.
# For example, if you have 'messages_vi.yml', set this to 'vi'.
# Available: Vienamese: vi, English: en
language: vi
#================================#
# Altar Settings #
#================================#
altar:
# Prevent other players from taking items placed on pedestals.
# If true, only the player who placed an item can take it back.
# Set to false to allow anyone to take items.
prevent-item-theft: true
# Broadcast a server-wide message when a boss is summoned.
broadcast-summon:
enabled: true
# The maximum radius (in blocks) from the center block that pedestals can be placed.
max-pedestal-radius: 10.0
#================================#
# Effect Settings #
#================================#
effects:
# Configure the height of various effects.
# Heights are measured from the bottom of the block (e.g., 0.5 is the block's center).
heights:
# Height of the particle effect on pedestals with a correct item.
pedestal: 1.2
# Height of the simple particle above the center block when the altar is ready.
ready-particle: 1.2
# The vertical offset of the ritual rings relative to the central item's position.
# 0.0 is exactly at the item's level.
ritual-ring-offset: 0.0
# Configure the particle types for various effects.
# A list of valid particle names can be found on the Spigot Javadocs.
particles:
altar-ready: "SOUL_FIRE_FLAME"
ritual-ring: "SOUL_FIRE_FLAME"
pedestal-ready: "END_ROD"
animation-trail: "ENCHANTMENT_TABLE"
animation-trail-secondary: "END_ROD"
convergence-burst: "END_ROD"
# Configure sounds for different stages.
# Format: "SOUND_NAME,Volume,Pitch"
# Example: "ENTITY_PLAYER_LEVELUP,1.0,1.0"
# A list of valid sound names can be found on the Spigot Javadocs.
sounds:
ritual-start: "BLOCK_BEACON_ACTIVATE,1.5,0.8"
ritual-ambient-loop: "BLOCK_CONDUIT_AMBIENT_SHORT,1.0,1.2"
ritual-items-fly: "ENTITY_PHANTOM_SWOOP,0.7,1.5"
ritual-converge: "ENTITY_GENERIC_EXPLODE,2.0,1.2"
summon-spawn: "ENTITY_WITHER_SPAWN,2.0,1.0"
# English language file for VtAlters
# You can use standard Minecraft color codes with '&'. Example: &c for red.
# Placeholders like %player%, %name%, etc., will be replaced by the plugin automatically.
# General plugin messages
general:
reloaded: '&aPlugin has been reloaded successfully.'
not-a-player: '&cThis command can only be executed by a player.'
no-permission: '&cYou do not have permission to use this command.'
usage: '&cUsage: %usage%'
plugin-has-errors: '&c[VtAlters] The plugin has detected errors and may not function correctly. Reasons: &e%reasons%&c. Please check the console for details and use &e/vta reload&c after fixing.'
# Wand related messages
wand:
given: '&aYou have been given the Altar Setup Wand.'
selection: '&dSelected block at &ex: %x%&d, &ey: %y%&d, &ez: %z%&d.'
error-no-selection: '&cYou must select a block with the wand first!'
# Altar command messages (create, delete, list, edit)
altar-commands:
# Creation
created: '&aSuccessfully created a new altar named &e%name%&a.'
error-altar-exists: '&cAn altar named &e%name% &calready exists.'
# Deletion
deleted: '&aSuccessfully deleted the altar named &e%name%&a.'
error-no-altar: '&cCould not find an altar named &e%name%&c.'
# Editing
center-set: '&aAltar center has been set to your selection.'
boss-set: '&aBoss for altar &e%name% &ahas been set to &e%mob%&a.'
center-item-set: '&aActivation item has been set to &e%item_name%&a.'
pedestal-added: '&aPedestal has been added to the altar.'
pedestal-removed: '&aPedestal has been removed from your selection.'
pedestals-cleared: '&aAll pedestals have been cleared for altar &e%name%&a.'
required-item-set: '&aSet &e%amount%x %item_name% &aas a required item.'
required-item-removed: '&aRemoved matching required item(s) from the altar.'
required-items-cleared: '&aAll required items have been cleared from the altar.'
# Editing Errors
error-no-item-in-hand: '&cYou must be holding an item in your main hand.'
error-must-set-center: '&cYou must set the altar''s center location before adding pedestals.'
error-pedestal-too-far: '&cThe selected pedestal is too far from the altar center (Max radius: %radius% blocks).'
error-pedestal-already-exists: '&cThis block is already registered as a pedestal.'
error-pedestal-not-found: '&cThe selected block is not a registered pedestal for this altar.'
error-no-pedestals-to-clear: '&cAltar &e%name% &chas no pedestals to clear.'
error-invalid-number: '&cPlease provide a valid positive number.'
error-no-required-items-to-remove: '&cThis altar has no required items to remove.'
error-no-matching-item-to-remove: '&cNo required item matched the item in your hand.'
error-must-add-pedestals-first: '&cYou must add pedestals to the altar before requiring items.'
error-items-exceed-pedestals: '&cCannot add. Total required items (%total_required%) would exceed pedestal count (%pedestal_count%).'
# Altar interaction messages (in-game use)
altar-interaction:
not-ready: '&cThe altar is not yet ready. More items are required.'
wrong-item: '&cYou have used the wrong item on the altar.'
ritual-start: '&5The ritual has begun...'
boss-spawned: '&aThe boss has been summoned!'
summoning: '&eAn altar ritual is already in progress here.'
not-your-item: '&cYou cannot take an item that you did not place.'
boss-summon-broadcast: '&6&lA Boss has Appeared! &e%player% &chas summoned &4&l%boss% &cvia an altar!'
error-invalid-boss: '&cError summoning boss: The boss type ''%boss%'' is invalid. Please contact a server administrator.'
# Help Messages
help:
header: '&6--- &e&lVtAlters Help &6---'
create: '&a/%label% create <name> &7- Create a new altar.'
delete: '&a/%label% delete <name> &7- Delete an altar.'
list: '&a/%label% list &7- List all altars.'
wand: '&a/%label% wand &7- Get the setup wand.'
reload: '&a/%label% reload &7- Reload the plugin.'
edit-header: '&6--- &eEdit Commands &6---'
edit-set-center: '&a/%label% edit <name> set center &7- Set the center block.'
edit-set-mob: '&a/%label% edit <name> set mob <mob> &7- Set the boss to summon.'
edit-add-itemcenter: '&a/%label% edit <name> add itemcenter &7- Set the activation item.'
edit-add-pedestal: '&a/%label% edit <name> add pedestal &7- Add a pedestal block.'
edit-add-item: '&a/%label% edit <name> add item <amount> &7- Add a required item.'
edit-remove-pedestal: '&a/%label% edit <name> remove pedestal [all] &7- Remove a pedestal(s).'
edit-remove-item: '&a/%label% edit <name> remove item [all] &7- Remove a required item(s).'