Créer des Arènes
Créer des 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 | Default name |
Exemple
arenaName: Bedrock Arena
corner1
Définit le premier coin de l'arène.
| Clé | Valeurs | Défaut |
|---|---|---|
corner1 | Location | aucun |
Exemple
corner1: my_arena_world,10,50,-10,0,0
Le format de l'emplacement est : world_name,x,y,z,yaw,pitch où world_name est le nom du monde, x/y/z sont les coordonnées, yaw est la rotation horizontale (0-360) et pitch est la rotation verticale (-90 à 90).
Sur 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 les deux comme étant l'arène, représentée par de la laine jaune.
corner2
Définit le second coin de l'arène, qui doit se trouver 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 | aucun |
Exemple
corner2: my_arena_world,-10,50,10,0,0
Sur 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 les deux comme étant l'arène, représentée par de la laine jaune.
startLocation
Définit l'emplacement de départ de l'arène.
| Clé | Valeurs | Défaut |
|---|---|---|
startLocation | Location | aucun |
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 | aucun |
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 | 0 |
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 de delayBetweenWaves * 2 pour ces vagues. Utile si vous voulez accorder aux joueurs un court répit entre certaines vagues.
| Clé | Valeurs | Défaut |
|---|---|---|
rawIntermissionWaves | Integer List | aucun |
Exemple
rawIntermissionWaves:
- '5'
- '10'
- '15'
spawnPoints
Définit les emplacements d'apparition des boss de l'arène.
| Clé | Valeurs | Défaut |
|---|---|---|
spawnPoints | String List [1] | aucun |
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] | aucun |
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. Puis, à la vague 2, un boss mythic apparaîtra, au niveau 10, au point central.
Notez que vous pouvez aussi forcer un niveau pour les boss EliteMobs à l'aide du paramètre level (par exemple, level=10), mais il est recommandé de définir leur niveau dans leur fichier de configuration par souci de cohérence. Le paramètre level est utile pour faire varier la difficulté de l'arène.
rawArenaReward
Définit les récompenses données à la fin des vagues.
Note : dans le code source, ce champ peut aussi être référencé sous le nom rawArenaRewards (au pluriel).
| Clé | Valeurs | Défaut |
|---|---|---|
rawArenaReward | Table de butin universelle EliteMobs | aucun |
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 démarrer.
| 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 | 0 |
Exemple
maximumPlayerCount: 100
arenaMessages
Définit les messages qui s'affichent entre les vagues.
| Clé | Valeurs | Défaut |
|---|---|---|
arenaMessages | Spécial [3] | aucun |
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 valeur par défaut est cuboïde).
| 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 | aucun |
Exemple
permission: mypermission.arena
teleportLocation
Définit l'endroit où les joueurs doivent être téléportés après avoir interagi avec le PNJ de l'arène. Ce réglage est généralement utilisé pour téléporter les joueurs vers une zone dédiée de type hall de l'arène, où ils peuvent lancer le défi de l'arène ou attendre que d'autres joueurs terminent leur passage dans l'arène.
| Clé | Valeurs | Défaut |
|---|---|---|
teleportLocation | Location | aucun |
Exemple
teleportLocation: my_arena_world,10,50,10,0,0
Spécial [1]
Points d'apparition : utilise le format suivant : name=pointName:location=world_name,x,y,z.
Spécial [2]
Liste de boss : utilise le format suivant : wave=x:spawnPoint=Y:boss=bossfilename.yml.
Spécial [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
Décomposition de l'exemple
Passons en revue cet exemple du début et expliquons ce que fait cette configuration d'arène.
D'abord, l'arène est activée avec isEnabled, et nous pouvons voir qu'elle s'appelle Example Arena grâce au réglage arenaName. Le nom sera affiché lorsque vous interagissez avec le PNJ de l'arène (nous expliquons comment créer un PNJ d'arène plus bas) qui permettra aux joueurs de rejoindre l'arène. corner1 et corner2 définissent la taille de l'arène. Ces coins devraient se trouver aux 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 durera l'arène. 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éfinit le nombre de secondes avant que la prochaine vague ne démarre. Dans notre exemple, les joueurs auraient 5 secondes pour se préparer avant le début de la vague suivante.
spawnPoints définit les emplacements où nos créatures peuvent apparaître. Nous pouvons en créer autant que nous le souhaitons et les nommer comme bon nous semble. 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 fera apparaître 3 boss depuis les emplacements d'apparition que nous avons nommés north, center et south. Tous les trois sont configurés pour utiliser le même fichier de boss, mais nous aurions pu utiliser des fichiers de boss différents 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 de 5 pièces d'élite. S'il parvient à survivre aux vagues restantes puis à battre la vague 5, il sera récompensé de 25 pièces d'élite et d'une chance de 50 % d'obtenir un MagmaGuy's Toothpick de niveau 5.
minimumPlayerCount définit le nombre minimum de joueurs requis avant que l'arène ne démarre. Dans notre exemple, ce réglage 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 réglage est défini sur 3, ce qui signifie que si plus de 3 joueurs tentent de participer à l'arène, alors l'arène ne démarrera pas tant qu'il n'y aura pas 3 joueurs ou moins.
arenaMessages vous permet d'ajouter un 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 aussi décidé d'inclure le nom du PNJ au début de chaque message, donnant l'illusion que le texte est un dialogue prononcé par l'annonceur (le maître d'arène).
cylindricalArena ce réglage nous permettra de basculer pour savoir si la zone définie que nous avons fixée avec corner1 et corner2 doit avoir une forme cylindrique plutôt que cuboïde. Dans notre exemple, nous l'avons défini sur false, ce qui signifie que l'arène d'exemple a une forme cuboïde.
permission nous permet de définir une permission que les joueurs devront avoir pour pouvoir rejoindre/lancer l'arène. Dans notre exemple, les joueurs auront besoin de la permission arena.mypermission pour pouvoir utiliser l'arène.
Créer le PNJ de l'arène
isEnabled
Définit si le PNJ est activé.
| Clé | Valeurs | Défaut |
|---|---|---|
isEnabled | Boolean | true |
Exemple
isEnabled: true
name
Définit le nom d'affichage du PNJ.
| Clé | Valeurs | Défaut |
|---|---|---|
name | String | aucun |
Exemple
name: "&aGladius"
role
Définit le rôle affiché sous le nom du PNJ.
| Clé | Valeurs | Défaut |
|---|---|---|
role | String | aucun |
Exemple
role: "&c<Arena Master>"
profession
Définit la profession Minecraft du PNJ.
| Clé | Valeurs | Défaut |
|---|---|---|
profession | Profession | NITWIT |
Exemple
profession: ARMORER
Sera remplacé si un disguise est utilisé.
spawnLocation
Définit l'emplacement d'apparition du PNJ.
| Clé | Valeurs | Défaut |
|---|---|---|
spawnLocation | Location | aucun |
Exemple
spawnLocation: my_world,1.5,50,1.5,-108,0
spawnLocations
Définit des emplacements d'apparition supplémentaires pour le PNJ. Cela permet à une seule configuration de PNJ de faire apparaître le PNJ à plusieurs emplacements.
| Clé | Valeurs | Défaut |
|---|---|---|
spawnLocations | String List | aucun |
Exemple
spawnLocations:
- my_world,1.5,50,1.5,-108,0
- my_world,100.5,50,50.5,0,0
greetings
Définit le dialogue de salutation du PNJ.
| Clé | Valeurs | Défaut |
|---|---|---|
greetings | String List | aucun |
Exemple
greetings:
- Welcome to the Arena!
- The Arena welcomes you!
dialog
Définit le dialogue lorsque les joueurs interagissent avec le PNJ.
| Clé | Valeurs | Défaut |
|---|---|---|
dialog | String List | aucun |
Exemple
dialog:
- Ready for a challenge?
- Face the Arena?
farewell
Définit le dialogue d'adieu du PNJ, affiché lorsqu'un joueur s'éloigne.
| Clé | Valeurs | Défaut |
|---|---|---|
farewell | String List | aucun |
Exemple
farewell:
- Bye.
- Return with your shield, or on it!
Si une chaîne de caractères 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 PNJ peut parler aux joueurs.
| Clé | Valeurs | Défaut |
|---|---|---|
canTalk | Boolean | true |
Exemple
canTalk: true
activationRadius
Définit le rayon auquel le PNJ doit commencer à parler.
| Clé | Valeurs | Défaut |
|---|---|---|
activationRadius | Double | 3.0 |
Exemple
activationRadius: 3.0
timeout
Définit le délai d'expiration du PNJ, en secondes. Lorsqu'il est défini, le PNJ disparaîtra après la durée spécifiée.
| Clé | Valeurs | Défaut |
|---|---|---|
timeout | Double | 0 |
Exemple
timeout: 60
interactionType
Définit le type d'interaction que le PNJ effectuera.
| Clé | Valeurs | Défaut |
|---|---|---|
interactionType | Spécial [4] | NONE |
Exemple
interactionType: ARENA_MASTER
disguise
Définit le déguisement personnalisé du PNJ.
| Clé | Valeurs | Défaut |
|---|---|---|
disguise | Disguise | aucun |
Exemple
disguise: ZOMBIE
customDisguiseData
Définit les données de déguisement personnalisé pour un déguisement LibsDisguises. Cela permet une personnalisation détaillée du déguisement au-delà du réglage de base disguise.
| Clé | Valeurs | Défaut |
|---|---|---|
customDisguiseData | String | aucun |
Exemple
customDisguiseData: player MHF_Pig
customModel
Définit le modèle personnalisé à utiliser pour le PNJ. Nécessite l'installation et la configuration d'un plugin de modèles personnalisés valide.
| Clé | Valeurs | Défaut |
|---|---|---|
customModel | String | aucun |
Exemple
customModel: my_model
arena
Définit vers quelle arène les joueurs seront téléportés.
| Clé | Valeurs | Défaut |
|---|---|---|
arena | Filename | aucun |
Exemple
arena: my_arena.yml
command
Définit la commande que le PNJ exécutera lorsqu'on interagit avec lui. Nécessite que interactionType soit défini sur COMMAND.
| Clé | Valeurs | Défaut |
|---|---|---|
command | String | aucun |
Exemple
command: say Hello $player
questFileName
Définit les noms de fichiers de quête pour le PNJ. Nécessite que interactionType soit défini sur CUSTOM_QUEST_GIVER.
| Clé | Valeurs | Défaut |
|---|---|---|
questFileName | String List | aucun |
Exemple
questFileName:
- my_quest_1.yml
- my_quest_2.yml
noPreviousLocationMessage
Lorsque l'interactionType est défini sur TELEPORT_BACK, ceci définit le message envoyé si le PNJ ne trouve pas d'emplacement précédent vers lequel téléporter le joueur.
| Clé | Valeurs | Défaut |
|---|---|---|
noPreviousLocationMessage | String | aucun |
Exemple
noPreviousLocationMessage: '&cCouldn''t find a previous location!'
instanced
Définit si le PNJ doit être instancié. Ceci est utilisé pour les PNJ à l'intérieur des donjons instanciés.
| Clé | Valeurs | Défaut |
|---|---|---|
instanced | Boolean | false |
Exemple
instanced: false
scale
Définit l'échelle (la taille) du PNJ.
| Clé | Valeurs | Défaut |
|---|---|---|
scale | Double | 1.0 |
Exemple
scale: 1.0
syncMovement
Définit si le mouvement du PNJ doit être synchronisé avec le serveur.
| Clé | Valeurs | Défaut |
|---|---|---|
syncMovement | Boolean | true |
Exemple
syncMovement: true
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 PNJ d'arène basique qui apparaîtra dans my_minecraft_world avec un déguisement de zombie. Les joueurs peuvent interagir avec ce PNJ pour défier l'Example Arena.
Spécial [4]
Voici la liste des types d'interaction de PNJ valides :
| Type | Description |
|---|---|
GUILD_GREETER | Ouvre le menu de la guilde des aventuriers |
CHAT | Le clic droit fait défiler le dialog |
CUSTOM_SHOP | Ouvre le menu de la boutique personnalisée |
PROCEDURALLY_GENERATED_SHOP | Ouvre la boutique générée procéduralement |
BAR | Ouvre le menu du bar |
ARENA | Ne fait rien. Utilisez ARENA_MASTER à la place. |
QUEST_GIVER | Ouvre le menu des quêtes générées procéduralement |
CUSTOM_QUEST_GIVER | Ouvre le menu de quête pour une quête spécifique définie dans questFileName |
NONE | Aucune interaction |
SELL | Ouvre le menu de vente |
TELEPORT_BACK | Téléporte les joueurs vers le dernier emplacement hors monde elitemobs où ils se trouvaient |
SCRAPPER | Ouvre le menu de récupération (scrap) |
SMELTER | DÉPRÉCIÉ - Fonctionnalité supprimée, ne pas utiliser |
REPAIRMAN | Ouvre le menu de réparation |
ENHANCER | DÉPRÉCIÉ - Fonctionnalité supprimée, ne pas utiliser |
REFINER | DÉPRÉCIÉ - Fonctionnalité supprimée, ne pas utiliser |
UNBINDER | Ouvre le menu de déliaison |
ARENA_MASTER | Ouvre le menu d'arène pour l'arène définie dans arena |
COMMAND | Exécute la commande définie dans command |
ENCHANTER | Ouvre le menu d'enchantement |
SCROLL_APPLIER | Ouvre le menu d'application de parchemins |
ARROW_SHOP | Ouvre le menu de la boutique de flèches |
GAMBLING_BLACKJACK | Ouvre le jeu d'argent de blackjack |
GAMBLING_COINFLIP | Ouvre le jeu d'argent de pile ou face |
GAMBLING_SLOTS | Ouvre le jeu d'argent de machine à sous |
GAMBLING_HIGHERLOWER | Ouvre le jeu d'argent plus haut/plus bas |