CustomItemsAPI

CustomItemsAPI
Plugin
Catégorie	NBT [edit]
Développeur(s)	goncalomb
Bukkit	customitems
Nefald
Status	non-installé [edit]
Grade requis	Architecte
Article
Dernière révision	10/02/2016

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

# ----- CustomItems ----- Item configuration file -----
# This file configures the custom items registed by CustomItemsAPI.
# For the changes to take effect you must reload the corresponding plugin.
# 
# Note regarding allowed-worlds/blocked-worlds:
#   allowed-worlds, when not empty, acts like a whitelist and only
#   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: []

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