CustomItemsAPI

CustomItemsAPI
Plugin
Catégorie	NBT [edit]
Développeur(s)	goncalomb
Bukkit	customitems
Nefald
Status	installé [edit]
Grade requis	Architecte
Article
Dernière révision	19/03/2014

CustomItemsAPI, développé par goncalomb, ajoute quelques items à Minecraft, ils sont tous basés sur des items existants et sont identifiés par leur nom. Le plugin a été développé par goncalomb, le développeur de NBTEditor avec qui il peut fonctionner.

Items

item	id	description
Bat Bomb	bat-bomb	Une bombe jetable qui relâche des chauve-souris, qui exploseront après quelques secondes.
Fire Bomb	fire-bomb	Une bombe jetable qui après avoir explosée mettra le feu à toutes les entités vivantes aux alentours.
Repulsion Bomb	repulsion-bomb	Une bombe jetable qui après avoir explosée repoussera toutes les entités vivantes aux alentours.
Lightning Rod	lightning-rod	Un item jetable qui lancera un éclair à son point de chute, au bout de quelques secondes.
Ender Bow	ender-bow	Un arc qui lance des Enderpearls.
Wither Bow	wither-bow	Un arc qui lance des crânes de Wither.
Sun Stick	sun-stick	Une fusée qui va changer lentement l'heure pour midi.
Moon Stick	moon-stick	Une fusée qui va changer lentement l'heure pour minuit.
Escape Plan	escape-plan	Une fusée qui peut-être utilisée sur vos ennemis afin de les emporter au loin.
Kings Crown	kings-crown	Un item rigolo qui va broadcaster un message lorsqu'on le ramasse ou le perd.
Mine	simple-mine	Une mine qui explose lorsqu'on la ramasse.
Torch Bow	torch-bow	Un arc qui place des torches.
Antimatter Bomb désactivé par défaut	anti-matter-bomb	Une bombe jetable qui va entièrement détruit la zone. C'est le seul item qui peut affecter le monde en lui-même.
Gravitational Axe	gravitational-axe	Une hache en diamant qui fait chuter les arbres.
Tree Vaporizer	tree-vaporizer	Une hache en diamant qui détruit entièrement les arbres.

Commandes et permissions

alias /citem

Commande	Description	Permission
/customitem get <item> [montant]	Obtenir l'item spécifié dans le montant voulu	customitemsapi.customitem.get
/customitem give <joueur> <item> [montant]	Donner l'item spécifié dans le montant souhaité, à quelqu'un.	customitemsapi.customitem.get
/customitem list	Lister tous les items disponibles	customitemsapi.customitem

Outils de NBTEditor

Il existe trois outils facilitant l'utilisation de NBTEditor, uniquement accessible grâce à CustomItemsAPI

bos-empty bos entity-inspector entity-remover super-lead

Notes

la permission customitemsapi.* donne accès à toutes les fonctionnalités (par défaut pour les OP)

Toutes les sous-commandes ont leur propre permission

• customitemsapi.customitem donne accès à la commande /customitem et à toutes ses sous-commandes (get, give et list)
• customitemsapi.customitem.get donne accès à la sous-commande /customitem give
• etc,...

Permissions par items

• customitemsapi.use.* - permet d'utiliser tous les items
• customitemsapi.use.<item> - permet d'utiliser un item en particulier (ex.: customitemsapi.use.wither-bow)
• customitemsapi.world-override.* - permet d'utiliser tous les items en dehors des mondes autorisés
• customitemsapi.world-override.<item> - permet d'utiliser un item en particulier, en dehors des mondes autorisés (ex.: customitemsapi.use.wither-bow)

Configuration

Le fichier de configuration se trouve dans le répertoire com.goncalomb/CustomItemsAPI/ItemsConfig/CustomItemsAPI.yml <syntaxhighlight lang="Yaml">

1. ----- CustomItems ----- Item configuration file -----
2. This file configures the custom items registed by CustomItemsAPI.
3. For the changes to take effect you must reload the corresponding plugin.
5. Note regarding allowed-worlds/blocked-worlds:
6. allowed-worlds, when not empty, acts like a whitelist and only
7. on worlds from this list the item will be enabled!

custom-items:

 bat-bomb:
   enabled: true
   name: §cBat Bomb
   lore:
   - §bLeft-click or drop key to throw the bomb.
   - §bRight-Click to spawn the bats at your location.
   - §bThe bats will explode after a few seconds.
   allowed-worlds: []
   blocked-worlds: []
   fuse: 50
   trigger-on-drop: false
   power: 3.8
 fire-bomb:
   enabled: true
   name: §cFire Bomb
   lore:
   - §bLeft-click or drop key to throw the bomb.
   - §bThe bomb will explode after a few seconds.
   allowed-worlds: []
   blocked-worlds: []
   fuse: 40
   trigger-on-drop: false
   radius: 9
 repulsion-bomb:
   enabled: true
   name: §eRepulsion Bomb
   lore:
   - §bLeft-click key to throw the bomb.
   - §bThe bomb will explode after a few seconds.
   allowed-worlds: []
   blocked-worlds: []
   fuse: 45
   trigger-on-drop: false
   radius: 11
   force: 1.8
 lightning-rod:
   enabled: true
   name: §7Lightning Rod
   lore:
   - §bLeft-click or drop key to throw the rod.
   - §bLightning will strike after a few seconds.
   allowed-worlds: []
   blocked-worlds: []
   fuse: 40
   trigger-on-drop: false
 ender-bow:
   enabled: true
   name: §aEnder Bow
   lore:
   - §bA bow that shoots Ender Pearls.
   allowed-worlds: []
   blocked-worlds: []
 wither-bow:
   enabled: true
   name: §aWither Bow
   lore:
   - §bA bow that shoots Wither Skulls.
   allowed-worlds: []
   blocked-worlds: []
 sun-stick:
   enabled: true
   name: §6Sun Stick
   lore:
   - §bA magic flying stick to controls time.
   - §bUse outside.
   allowed-worlds: []
   blocked-worlds: []
 moon-stick:
   enabled: true
   name: §3Moon Stick
   lore:
   - §bA magic flying stick to controls time.
   - §bUse outside.
   allowed-worlds: []
   blocked-worlds: []
 escape-plan:
   enabled: true
   name: §eEscape Plan
   lore:
   - §bSteve Co. Space Program!
   - §bProvides a quick escape from your foes.
   - §b... or just send 'em into spaaaace!
   - §bUse on open areas.
   allowed-worlds: []
   blocked-worlds: []
 kings-crown:
   enabled: true
   name: §6King's Crown
   lore: []
   allowed-worlds: []
   blocked-worlds: []
 simple-mine:
   enabled: true
   name: §aMine
   lore:
   - §bDrop it and don't pick it up.
   allowed-worlds: []
   blocked-worlds: []
 torch-bow:
   enabled: true
   name: §eTorch Bow
   lore:
   - §bLight the way with arrows.
   allowed-worlds: []
   blocked-worlds: []
 anti-matter-bomb:
   enabled: false
   name: §aAnti-Matter Bomb
   lore:
   - §c§k----- §c§lCaution! §r§c§k-----
   allowed-worlds: []
   blocked-worlds: []
   fuse: 60
   trigger-on-drop: false
   cleanup: true
 gravitational-axe:
   enabled: true
   name: §7Gravitational Axe
   lore: []
   allowed-worlds: []
   blocked-worlds: []
 tree-vaporizer:
   enabled: true
   name: §aTree Vaporizer
   lore: []
   allowed-worlds: []
   blocked-worlds: []

</syntaxhighlight>

Explications

• bat-bomb - id
• enabled - activé ou non l'item (true ou false)
• name - nom de l'item
• lore - lignes de description
  • §bligne1
  • §bligne2
  • §bligne3
• allowed-worlds - mondes où l'utilisation de l'item est permise
• blocked-worlds - mondes où l'utilisation de l'item n'est pas permise
• fuse 50
• trigger-on-drop- activation de l'item sur le drop (true ou false)
• power - puissance de l'item

Références

• Documentation de CustomItemsAPI par goncalomb