Création d'Arènes

Création d'arènes

isEnabled

Définit si l'arène est activée.

Clé	Valeurs	Défaut
`isEnabled`	Boolean	`true`

Exemple

isEnabled: true

arenaName

Définit le nom de l'arène.

Clé	Valeurs	Défaut
`arenaName`	String	aucune

Exemple

arenaName: Bedrock Arena

corner1

Définit le premier coin de l'arène.

Clé	Valeurs	Défaut
`corner1`	Location	aucune

Exemple

corner1: my_arena_world,10,50,-10,0,0

Le format de l'emplacement est : nom_du_monde,x,y,z,lacet,tangage où nom_du_monde est le nom du monde, x/y/z sont les coordonnées, lacet est la rotation horizontale (0-360), et tangage est la rotation verticale (-90 à 90).

Dans cette image, corner1 est représenté par de la laine verte et corner2 est représenté par de la laine rouge. Cette configuration désigne la zone entre eux comme l'arène, représentée par de la laine jaune.

corner2

Définit le deuxième coin de l'arène, doit être au coin opposé de corner1. Ces deux coins définissent les limites de l'espace de votre arène.

Clé	Valeurs	Défaut
`corner2`	Location	aucune

Exemple

corner2: my_arena_world,-10,50,10,0,0

startLocation

Définit l'emplacement de départ de l'arène.

Clé	Valeurs	Défaut
`startLocation`	Location	aucune

Exemple

startLocation: my_arena_world,1,50,1,0,0

exitLocation

Définit l'emplacement de sortie de l'arène.

Clé	Valeurs	Défaut
`exitLocation`	Location	aucune

Exemple

exitLocation: my_world,1,50,1,0,0

waveCount

Définit le nombre de vagues que l'arène comporte.

Clé	Valeurs	Défaut
`waveCount`	Integer	aucune

Exemple

waveCount: 10

delayBetweenWaves

Définit le délai, en secondes, entre les vagues.

Clé	Valeurs	Défaut
`delayBetweenWaves`	Integer	`0`

Exemple

delayBetweenWaves: 5

rawIntermissionWaves

Double le délai entre les vagues pour les vagues spécifiées dans la liste. Le délai sera delayBetweenWaves * 2 pour ces vagues. Utile si vous souhaitez donner aux joueurs une courte pause entre certaines vagues.

Clé	Valeurs	Défaut
`rawIntermissionWaves`	Integer List	aucune

Exemple

rawIntermissionWaves:
- '5'
- '10'
- '15'

spawnPoints

Définit les emplacements d'apparition pour les boss d'arène.

Clé	Valeurs	Défaut
`spawnPoints`	String List [1]	aucune

Exemple

spawnPoints:
- name=north:location=my_arena_world,219.5,71,273.5
- name=south:location=my_arena_world,219.5,71,316.5
- name=west:location=my_arena_world,197.5,71,295.5
- name=east:location=my_arena_world,240.5,71,295.5
- name=center:location=my_arena_world,219.5,71,295.5

bossList

Définit la liste des boss qui apparaissent pendant les vagues de l'arène. Les arènes EliteMobs prennent en charge l'apparition de Mythic Mobs dans les arènes.

Clé	Valeurs	Défaut
`bossList`	String List [2]	aucune

Exemple

bossList:
- wave=1:spawnPoint=north:boss=my_boss_wave_1.yml
- wave=1:spawnPoint=south:boss=my_boss_wave_1.yml
- wave=2:spawnPoint=center:boss=my_mythicmobs_boss:mythicmob=true:level=10

Dans cet exemple, la vague 1 fera apparaître un boss au point d'apparition nord et un boss au point d'apparition sud. Ensuite, à la vague 2, un boss mythique apparaîtra, au niveau 10, au point central.

Notez que vous pouvez également forcer un niveau pour les boss EliteMobs en utilisant le paramètre level (par exemple, level=10), mais il est recommandé de définir leur niveau dans leur fichier de configuration pour plus de cohérence. Le paramètre level est utile pour ajuster la difficulté de l'arène.

rawArenaReward

Définit les récompenses données à la fin des vagues.

Remarque : Dans le code source, ce champ peut également être référencé comme rawArenaRewards (au pluriel).

Clé	Valeurs	Défaut
`rawArenaReward`	Universal EliteMobs loot table	aucune

Exemple

rawArenaReward:
- filename=enchanted_book_damage_all.yml:wave=5:chance=0.25
- filename=elite_scrap_tiny.yml:wave=1:chance=0.5:amount=5
- currencyAmount=3:wave=3
- level=5:filename=summon_merchant_scroll.yml:wave=5
- filename=magmaguys_toothpick.yml:itemlevel=10:wave=10:chance=0.95

minimumPlayerCount

Définit le nombre minimum de joueurs qu'une arène doit avoir avant de commencer.

Clé	Valeurs	Défaut
`minimumPlayerCount`	Integer	`1`

Exemple

minimumPlayerCount: 1

maximumPlayerCount

Définit le nombre maximum de joueurs qu'une arène peut avoir.

Clé	Valeurs	Défaut
`maximumPlayerCount`	Integer	`100`

Exemple

maximumPlayerCount: 100

arenaMessages

Définit les messages qui s'exécutent entre les vagues.

Clé	Valeurs	Défaut
`arenaMessages`	Special [3]	aucune

Exemple

arenaMessages:
- wave=1:message="&a[Arena Announcer] &fTime for wave one!"
- wave=2:message="&a[Arena Announcer] &fWow, wave two already."

cylindricalArena

Définit si l'arène utilise une forme cylindrique (la forme par défaut est cubique).

Clé	Valeurs	Défaut
`cylindricalArena`	Boolean	`false`

Exemple

cylindricalArena: false

permission

Définit la permission requise pour utiliser l'arène.

Clé	Valeurs	Défaut
`permission`	String	aucune

Exemple

permission: mypermission.arena

Special [1]

Points d'apparition : Utilise le format suivant : name=pointName:location=world_name,x,y,z.

Special [2]

Liste des boss : Utilise le format suivant : wave=x:spawnPoint=Y:boss=bossfilename.yml.

Special [3]

Messages d'arène : Utilise le format suivant : wave=X:message=votre message ici.

Exemple de Configuration d'Arène

isEnabled: true
arenaName: Example Arena
corner1: my_arena_world,0,0,0,0,0
corner2: my_arena_world,50,50,50,0,0
startLocation: my_arena_world,25,0,25,0,0
exitLocation: my_minecraft_world,234,44,245,0,0
waveCount: 5
delayBetweenWaves: 5
spawnPoints:
  - name=north:location=my_arena_world,40.5,0,0
  - name=south:location=my_arena_world,10.5,0,0
  - name=west:location=my_arena_world,0,0,40.5
  - name=east:location=my_arena_world,0,0,10.5
  - name=center:location=my_arena_world,25.5,0,25.5
bossList:
  - wave=1:spawnPoint=north:boss=example_arena_wave_1_mob.yml
  - wave=1:spawnPoint=center:boss=example_arena_wave_1_mob.yml
  - wave=1:spawnPoint=south:boss=example_arena_wave_1_mob.yml
  - wave=2:spawnPoint=center:boss=example_arena_wave_2_mob.yml
  - wave=3:spawnPoint=east:boss=example_arena_wave_3_mob.yml
  - wave=3:spawnPoint=west:boss=example_arena_wave_3_mob.yml
  - wave=4:spawnPoint=center:boss=example_arena_wave_4_mob.yml
  - wave=4:spawnPoint=center:boss=example_arena_wave_4_mob.yml
  - wave=5:spawnPoint=center:boss=example_arena_wave_5_mob.yml
  - wave=5:spawnPoint=south:boss=example_arena_wave_5_mob.yml
  - wave=5:spawnPoint=west:boss=example_arena_wave_5_mob.yml
rawArenaReward:
  - currencyAmount=5:wave=1
  - currencyAmount=10:wave=2
  - currencyAmount=15:wave=3
  - currencyAmount=20:wave=4
  - currencyAmount=25:wave=5
  - filename=magmaguys_toothpick.yml:itemlevel=5:wave=5:chance=0.5
minimumPlayerCount: 1
maximumPlayerCount: 3
arenaMessages:
  - wave=1:message=&d[Arena NPC] &fWow! Wave 1!
  - wave=2:message=&d[Arena NPC] &fAmazing it is wave 2!
  - wave=3:message=&d[Arena NPC] &fWave 3 is now on!
  - wave=4:message=&d[Arena NPC] &fWave 4 already!
  - wave=5:message=&d[Arena NPC] &fWell it is all over after this one.
cylindricalArena: false
permission: arena.mypermission

Analyse de l'exemple

Passons en revue cet exemple depuis le début et expliquons ce que cette configuration d'arène fait.

Tout d'abord, l'arène est activée avec isEnabled, et nous pouvons voir qu'elle s'appelle Example Arena en utilisant le paramètre arenaName. Le nom sera affiché lorsque vous interagissez avec le NPC d'arène (nous expliquons comment créer un NPC d'arène plus loin) qui permettra aux joueurs de rejoindre l'arène. corner1 et corner2 définissent la taille de l'arène. Ces coins doivent se trouver sur les côtés opposés l'un de l'autre dans la zone que vous prévoyez d'utiliser pour l'arène.

startLocation est l'endroit où les joueurs apparaîtront en rejoignant l'arène, dans l'exemple ce serait au centre de l'arène dans le monde my_arena_world. exitLocation est l'endroit où les joueurs seront téléportés après avoir échoué ou terminé l'arène. Dans ce cas, ce serait le monde my_minecraft_world et les coordonnées de l'exemple.

waveCount définit simplement le nombre de vagues que l'arène durera. Dans ce cas, ce serait 5 vagues. Si les joueurs parviennent à survivre aux 5 vagues, ils ont réussi à survivre à l'arène. delayBetweenWaves définira le nombre de secondes avant le début de la prochaine vague. Dans notre exemple, les joueurs auraient 5 secondes pour se préparer avant le début de la prochaine vague.

spawnPoints définissent les emplacements où nous pouvons faire apparaître nos mobs. Nous pouvons en créer autant que nous le souhaitons et les nommer comme nous le voulons. Dans l'exemple, nous avons décidé de créer 5 points d'apparition et de les nommer north, south, center, east et west.

bossList est l'endroit où nous définissons quel boss doit apparaître à quelle vague et à quel emplacement. Dans l'exemple, la vague 1 aura 3 boss apparaissant depuis les emplacements d'apparition que nous avons nommés north, center et south. Les trois sont configurés pour utiliser le même fichier de boss, mais nous aurions pu utiliser différents fichiers de boss pour chacun.

rawArenaReward définit les récompenses qui seront distribuées après qu'un joueur parvient à survivre/battre une vague. Comme nous pouvons le voir dans l'exemple, battre la vague 1 récompensera le joueur avec 5 pièces d'élite. S'ils parviennent à survivre au reste des vagues puis à battre la vague 5, ils seront récompensés par 25 pièces d'élite et une chance de 50 % d'obtenir un Cure-dent de MagmaGuy de niveau 5.

minimumPlayerCount définit le nombre minimum de joueurs requis avant le démarrage de l'arène. Dans notre exemple, ce paramètre est défini sur 1, donc un seul joueur est nécessaire pour que l'arène démarre. maximumPlayerCount définit le nombre maximum de joueurs pouvant participer à l'arène. Dans notre exemple, ce paramètre est défini sur 3, ce qui signifie que si plus de 3 joueurs tentent de participer à l'arène, l'arène ne démarrera pas tant qu'il n'y aura pas 3 joueurs ou moins.

arenaMessages vous permet d'ajouter du texte d'ambiance qui sera affiché dans le chat au début des vagues définies. Dans notre exemple, nous avons décidé d'afficher un court message au début de chaque vague. Nous avons également décidé d'inclure le nom du NPC au début de chaque message donnant l'illusion que le texte est un dialogue parlé par l'annonceur (maître d'arène).

cylindricalArena ce paramètre nous permettra de basculer si la zone définie que nous avons définie avec corner1 et corner2 doit être une forme cylindrique au lieu d'une forme cubique. Dans notre exemple, nous avons défini cela sur false, ce qui signifie que l'exemple d'arène est une forme cubique.

permission nous permet de définir une permission que les joueurs devront avoir pour pouvoir rejoindre/démarrer l'arène. Dans notre exemple, les joueurs auront besoin de la permission arena.mypermission pour pouvoir utiliser l'arène.

Création du NPC d'Arène

isEnabled

Définit si le NPC est activé.

Clé	Valeurs	Défaut
`isEnabled`	Boolean	`true`

Exemple

isEnabled: true

name

Définit le nom d'affichage du NPC.

Clé	Valeurs	Défaut
`name`	String	aucune

Exemple

name: "&aGladius"

role

Définit l'affichage du rôle sous le nom du NPC.

Clé	Valeurs	Défaut
`role`	String	aucune

Exemple

role: "&c<Arena Master>"

profession

Définit la profession MineCraft du NPC.

Clé	Valeurs	Défaut
`profession`	Profession	aucune

Exemple

profession: ARMORER

Sera remplacé si un disguise est utilisé.

spawnLocation

Définit l'emplacement d'apparition du NPC.

Clé	Valeurs	Défaut
`spawnLocation`	Location	aucune

Exemple

spawnLocation: my_world,1.5,50,1.5,-108,0

greetings

Définit le dialogue de salutation pour le NPC.

Clé	Valeurs	Défaut
`greetings`	String List	aucune

Exemple

greetings:
- Welcome to the Arena!
- The Arena welcomes you!

dialog

Définit le dialogue lorsque les joueurs interagissent avec le NPC.

Clé	Valeurs	Défaut
`dialog`	String List	aucune

Exemple

dialog:
- Ready for a challenge?
- Face the Arena?

farewell

Définit le dialogue d'adieu pour le NPC.

Clé	Valeurs	Défaut
`farewell`	String List	aucune

Exemple

farewell:
- Bye.
- Return with your shield, or on it!

Si une chaîne est trop longue, vous pouvez utiliser \n pour séparer la chaîne en plusieurs lignes.

farewell:
- Bye.
- Return with your\nshield, or on it!

canTalk

Définit si le NPC peut parler aux joueurs.

Clé	Valeurs	Défaut
`canTalk`	Boolean	`true`

Exemple

canTalk: true

activationRadius

Définit le rayon auquel le NPC devrait commencer à parler.

Clé	Valeurs	Défaut
`activationRadius`	Double	`3.0`

Exemple

activationRadius: 3.0

interactionType

Définit le type d'interaction que le NPC effectuera.

Clé	Valeurs	Défaut
`interactionType`	Special [4]	`ARENA_MASTER`

Exemple

interactionType: ARENA_MASTER

disguise

Définit le déguisement personnalisé du NPC.

Clé	Valeurs	Défaut
`disguise`	Disguise	aucune

Exemple

disguise: ZOMBIE

arena

Définit vers quelle arène les joueurs seront téléportés.

Clé	Valeurs	Défaut
`arena`	Filename	aucune

Exemple

arena: my_arena.yml

teleportLocation

Définit où les joueurs doivent être téléportés après avoir interagi avec le NPC. Ce paramètre est généralement utilisé pour téléporter les joueurs vers une zone de type lobby dédiée de l'arène où ils peuvent commencer le défi de l'arène ou attendre que d'autres joueurs finissent de traverser l'arène.

Clé	Valeurs	Défaut
`teleportLocation`	Location	aucune

Exemple

teleportLocation: my_arena_world,10,50,10,0,0

Exemple de Configuration d'Arène

isEnabled: true
name: Example NPC
role: <Arena Master>
profession: ARMORER
spawnLocation: my_minecraft_world,233,44,245,0,0
greetings:
  - Welcome to the Arena!
dialog:
  - Ready to enter the Arena?
farewell:
  - Bye!
canTalk: true
activationRadius: 3.0
interactionType: ARENA_MASTER
disguise: ZOMBIE
arena: example_arena.yml

Cet exemple montre un NPC d'arène de base qui apparaîtra dans my_minecraft_world avec un déguisement de zombie. Les joueurs peuvent interagir avec ce NPC pour défier l'Example Arena.

Special [4]

Voici la liste des types d'interaction NPC valides :

Type	Description
`GUILD_GREETER`	Ouvre le menu de la guilde des aventuriers
`CHAT`	Le clic droit fait défiler les `dialog`
`CUSTOM_SHOP`	Ouvre le menu de la boutique personnalisée
`PROCEDURALLY_GENERATED_SHOP`	Ouvre la boutique générée de manière procédurale
`BAR`	Ouvre le menu du bar
`ARENA`	Ouvre le menu de l'arène
`QUEST_GIVER`	Ouvre le menu des quêtes générées de manière procédurale
`CUSTOM_QUEST_GIVER`	Ouvre le menu de quête pour une quête spécifique définie dans `questFilenames`
`NONE`	Aucune interaction
`SELL`	Ouvre le menu de vente
`TELEPORT_BACK`	Téléporte les joueurs au dernier emplacement du monde non-elitemobs où ils se trouvaient
`SCRAPPER`	Ouvre le menu de ferraille
`SMELTER`	Ouvre le menu de fonte
`REPAIRMAN`	Ouvre le menu de réparation
`ENHANCER`	Ouvre le menu d'améliorations d'objets
`REFINER`	Ouvre le menu de raffinerie
`UNBINDER`	Ouvre le menu de déliaison
`ARENA_MASTER`	Ouvre le menu de l'arène pour l'arène définie dans `arenaFilename`
`COMMAND`	Exécute la commande définie dans `command`