Quick Start
Install and Experience Zaphkiel
Guide
Install the plugin to the server
- After downloading the plugin, place its
Zaphkiel.jarfile into the server'spluginsfolder - Restart the server to load the plugin
- Once the plugin is loaded, it will generate the default
Zaphkielconfiguration under thepluginsfolder
Verify the plugin is loaded successfully
[07:09:27] [Server thread/INFO]: [Zaphkiel] Loading server plugin Zaphkiel v2.1.0
...
[07:09:33] [Server thread/INFO]: [Zaphkiel] Enabling Zaphkiel v2.1.0Check the generated folder structure
The following directory structure will be created automatically when the plugin starts:
config.yml [Main Configuration File]
data.db [SQLite File]
datasource.yml [Datasource Configuration]
def.yml [Default Sample Item]
def.yml [Default Display Template]
kether.yml [Kether Message Configuration]
Create your first item
Create a my_items.yml file in the plugins/Zaphkiel/item/ directory:
magic_sword:
icon: diamond_sword
name:
item_name: '&6Magic Sword'
lore:
item_type: '&9Legendary Weapon'
item_description:
- '&fA divine weapon filled with magic'
- '&7Right-click to unleash magic skills'
data:
damage: 100
level: 5
data-mapper:
damage: it
level: it
event:
interact:
script: "tell '&aYou unleashed magic! Dealt &c<damage> &adamage!'"Reload the configuration and test the item
/zaphkiel reloadAfter a successful reload, you will see output similar to the following:
[Zaphkiel] Loaded 1 items (0 models)
[Zaphkiel] Loaded 1 display plansObtain and test your item
Join the server and use the following command to get the item:
/zaphkiel give magic_swordRight-click the item to test the event function—you should see the following message displayed in the chat:
You unleashed magic! Dealt 100 damage!Next Steps
Congratulations! You have successfully created your first Zaphkiel item. Next, you can:
- Learn about Display Templates to create reusable display templates
- Check Item Configuration to learn more configuration options
- Learn about Item Groups to organize and manage your custom items
- Use the Metadata System to add special functions to items
- Study Data Mapping to use item data as variables
- Explore the Event System to add complex interaction behaviors to items
- Enable Internationalization Support to provide a multilingual experience for your items