Updated Scripts (markdown)

Daniel Saukel 2020-10-19 20:16:00 +02:00
parent 0eade3879a
commit 7b76a9ded1

@ -110,56 +110,7 @@ dog: true
## Mobs
Besides support for multiple external custom mob plugins, _DungeonsXL_ also has its own custom mob system. Just create a script and the identifier can be used at a mob sign instead of the vanilla mob name.
_The custom mob feature currently does not use the Caliburn format because it is not mature enough at the moment. Note that this format is deprecated and will be removed sooner or later._
```
# Type of the Mob
type: Skeleton
# Health
maxHealth: 100
# Head-item
itemHelmet: 310
# Chest-item
itemChestplate: 310
# Legging-item
itemLeggings: 310
#Feet-item
itemBoots: 310
# Hand-item
itemHand: 310
# If the Mob is a Wither skeleton (only available if Type: Skeleton)
isWitherSkeleton: true
# Which type of Ocelot an Ocelot is (only available if Type: Ocelot) // BLACK_CAT, RED_CAT, SIAMESE_CAT, WILD_OCELOT
ocelotType: BLACK_CAT
# Items that are dropped by the Mob upon death
drops:
1:
# Item-Id
id: 35
# Item-Data (As sample for colored wool)
data: 9
# Count (default 1)
amount: 2
# Enchantments
enchantments:
# Enchantment + Level
- DAMAGE_ALL 2
- DURABILITY 10
# Item name
name: 'The wool'
# Item description (Split multiple lines with '//')
lore: 'Finest wool!//Very fine!'
# Drop Chance (0-100) (default 100)
chance: 50
2:
id: 276
enchantments:
- DAMAGE_ALL 5
- DURABILITY 10
name: 'Destroyer'
lore: '10 Dmg'
```
As of build #1026, custom mobs are not stored in DungeonsXL's scripts folder anymore and use [a new format](https://github.com/DRE2N/CaliburnAPI/wiki/custom-mobs).
## Signs
Sometimes, it is hard to put all the triggers at one tiny line of a sign. And sometimes, there might not be enough space for multiple signs in a tiny room. The solution for this problem is called [script sign](signs#script). A script sign does everything that its script tells it to do.
@ -180,73 +131,9 @@ Sometimes, it is hard to put all the triggers at one tiny line of a sign. And so
If you include signs that replace the block the sign like [block] signs, make sure to put this sign last sothat none of the other signs overrides the block change.
## Loot tables
Loot tables can be used to add chance values for items in [reward chests](signs#chest).
Loot tables can be used to add chance values for items in [reward chests](signs#chest), mob drops, equipment and more.
In future versions, they will also be used for mob drops.
```
0:
# For more information about the Caliburn item serialization format,
# please have a look at the Caliburn wiki:
# https://github.com/DRE2N/CaliburnAPI/wiki/Custom-item-script
item:
==: de.erethon.caliburn.item.ExItem
type: "DEFAULT"
material: "STICK"
amount: 3
name: "&4CustomName"
lores:
- "&4This is the first line."
- "&6This is the second line."
itemFlags:
- "HIDE_ATTRIBUTES"
- "HIDE_ENCHANTS"
enchantments:
"PROTECTION_ENVIRONMENTAL": 4
"THORNS": 1
attributes:
nameOfFirstAttribute:
type: "GENERIC_ATTACK_DAMAGE"
slots:
- "MAIN_HAND"
- "OFF_HAND"
- "HEAD"
- "TORSO"
- "LEGS"
- "FEET"
operation: "ADD_NUMBER"
amount: 8.5
nameOfSecondAttribute:
type: "GENERIC_MOVEMENT_SPEED"
slots:
- "OFF_HAND"
operation: "ADD_NUMBER"
amount: 8.5
# The loot chance in percent
chance: 75.0
1:
# This is the simple way to store items.
# Valid input:
# The first value may be any ID (be it a Vanilla ID or an ID of an ItemsXL item),
# the second value is the amount
# and the third, optional value is the durability value.
item: "261,1,16"
chance: 100.0
2:
# The Caliburn API also supports the usual Bukkit ItemStack deserialization format.
# If you don't know how to use this and have ItemsXL installed,
# put the item stack into your main hand and enter the "/ixl serialize" command.
# You will find a valid, automatically generated YAML representation of your item
# in the ItemsXL/serialized.yml file.
item:
==: org.bukkit.inventory.ItemStack
type: IRON_SWORD
damage: 55
amount: 1
chance: 37.5
```
As of build #1026, loot tables are not stored in DungeonsXL's scripts folder anymore and use [a new format](https://github.com/DRE2N/CaliburnAPI/wiki/loot-tables).
## Commands
### WARNING: Do not use this feature to spawn mobs. Use mob signs and the custom mob provider registry in the main config instead.