Voir la source de CustomItemsAPI

{{Infobox Plugin| image = No_Logo.png| catégorie = NBT| dev = goncalomb| bukkit = customitems| grade = Architecte | status = installé|}}

'''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 ==

{| class="wikitable2"
!{{cc|jaune|'''item'''}}
!{{cc|jaune|'''id'''}}
!{{cc|jaune|'''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''' <small>{{Rouge|désactivé par défaut}}</small>
|''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 <code>/citem</code>
{| class="wikitable2"
!'''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 <code>customitemsapi.*</code> donne accès à toutes les fonctionnalités <small>(par défaut pour les OP)</small>

;Toutes les sous-commandes ont leur propre permission
* <code>customitemsapi.customitem</code> donne accès à la commande ''/customitem'' et à toutes ses sous-commandes (''get'', ''give'' et ''list'')
* <code>customitemsapi.customitem.get</code> donne accès à la sous-commande ''/customitem give''
* ''etc,...''

=== Permissions par items ===
* <code>customitemsapi.use.*</code>  - permet d'utiliser tous les items
* <code>customitemsapi.use.<item></code> - permet d'utiliser un item en particulier ('''ex.''': ''customitemsapi.use.wither-bow'')
* <code>customitemsapi.world-override.*</code> - permet d'utiliser tous les items en dehors des mondes autorisés
* <code>customitemsapi.world-override.<item></code> - 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">
# ----- 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: []
</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 ==
* [http://goncalomb.com/projects/customitemsapi Documentation de CustomItemsAPI] par goncalomb