All editor fields¶
This reference is generated from the current greatnpc/fields.json and English language resource. It lists editor metadata, including fields used for one NPC's local state.
Editor values are not always preset JSON
The editor transports many values as strings. For example, its duration input accepts readable text, while preset cooldown_in_seconds is a JSON number. Use the preset reference for file types. Some local-only editor fields are not serialized in TrainerPreset.
144 editor fields are listed below. Hidden fields remain documented for reference; not every field is shown for every NPC type or screen state.
General¶
preset¶
Source Preset
Preset ID in trainer_preset, such as custom/bt1. Used when Follow Preset is enabled.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
follow_preset¶
Follow Preset
Copy settings from the preset when it loads or reloads. Editing a setting here turns this off.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | true |
Appearance¶
display_name¶
Name
Name shown above the NPC.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
name_transparent¶
Transparent Name Background
Remove the dark background behind the floating name.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | false |
shadow¶
Shadow
Turn this off to hide the NPC's shadow.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | true |
hitbox_width¶
Hitbox Width
Width in blocks (0 to 4). Use 0 for the model default. Changes are shown in the preview.
| Property | Value |
|---|---|
| Editor type | NUMBER |
| Editor default | 0 |
| NPC kinds | "humanoid" |
hitbox_height¶
Hitbox Height
Height in blocks (0 to 4). Use 0 for the model default. Changes are shown in the preview.
| Property | Value |
|---|---|
| Editor type | NUMBER |
| Editor default | 0 |
| NPC kinds | "humanoid" |
hitbox_follow_pose¶
Fit Hitbox to Pose
Fit the humanoid's hitbox to its pose for any dimension set to 0. Explicit dimensions take priority.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | true |
| NPC kinds | "humanoid" |
light_level¶
Light Level
Set the NPC's visual brightness from 0 to 15, or use -1 for ambient light. This does not light surrounding blocks.
| Property | Value |
|---|---|
| Editor type | NUMBER |
| Editor default | -1 |
show_level_label¶
Show Level Above Name
Display Lvl: N above the NPC's floating name.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | false |
level_label¶
Level Label
Use 1 to 100, or X, XX, or XXX to conceal the level.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "10" |
skin_type¶
Skin Source
Use texturepack for a resource pack skin, url for a PNG link, or player for a Minecraft username.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "texturepack" |
| Accepted option IDs | "texturepack", "url", "player" |
| NPC kinds | "humanoid" |
texture¶
Skin
Enter the skin name, direct PNG URL, or username for the selected source.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| NPC kinds | "humanoid" |
skin_model¶
URL Skin Model
Use slim for narrow arms or default for wide arms. Player skins use their original model.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "slim" |
| Accepted option IDs | "slim", "default" |
| NPC kinds | "humanoid" |
render_scale¶
Visual Scale
Scale the rendered NPC. Use 1 for normal size.
| Property | Value |
|---|---|
| Editor type | NUMBER |
| Editor default | 1 |
hide_name_tag¶
Hide Name
Hide the floating name above the NPC.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | false |
Movement¶
see_distance¶
Look Distance (blocks)
Distance at which enabled gaze targets attract the NPC's attention.
| Property | Value |
|---|---|
| Editor type | NUMBER |
| Editor default | 15 |
look_at_players¶
Look at Players
Turn the NPC's head toward nearby players.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | true |
look_at_mobs¶
Look at Mobs
Turn toward nearby mobs, including Pokémon. Players and NPCs are separate targets.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | false |
look_at_npcs¶
Look at NPCs
Turn toward other nearby NPCs.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | false |
look_around¶
Look Around
Look in random directions when no enabled gaze target is nearby.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | false |
movable¶
Can Be Pushed
Allow players and other entities to push the NPC.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | false |
can_walk¶
Wander
Let the NPC walk around its home position.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | false |
wander_radius¶
Wander Radius (blocks)
Maximum distance the NPC can wander from home.
| Property | Value |
|---|---|
| Editor type | NUMBER |
| Editor default | 5 |
wander_interval_seconds¶
Wander Interval (s)
Time between destination choices. Enter seconds or a range such as 5-15.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "10" |
return_home_seconds¶
Return Home Interval (s)
Time between returns to the home position. Use 0 to disable.
| Property | Value |
|---|---|
| Editor type | NUMBER |
| Editor default | 60 |
walk_speed¶
Walking Speed
Walking speed multiplier. Use 1 for normal speed or 0.3 for slow walking.
| Property | Value |
|---|---|
| Editor type | NUMBER |
| Editor default | 0.5 |
home_pos¶
Home Position (x y z)
The NPC returns to this position. Leave blank to use its current position next time. This setting is local to the NPC.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
Pokémon¶
pokemon_species¶
Species
Choose the Pokémon this NPC displays, such as pikachu.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| NPC kinds | "pokemon" |
pokemon_aspects¶
Aspects and Form
Enter one aspect per line without spaces, such as alolan, female, or cosmetic_item=league.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| NPC kinds | "pokemon" |
| List separator | " " |
One aspect per line, without spaces. Examples: shiny, alolan, female, cosmetic_item=league. Suggestions match the selected species.
pokemon_shiny¶
Shiny
Use the species' Shiny appearance.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | false |
| NPC kinds | "pokemon" |
shiny_particles¶
Shiny Particles
Show particles when this Pokémon NPC is Shiny.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | true |
| NPC kinds | "pokemon" |
shiny_sound¶
Shiny Sound
Use off for silence, loop to play with the particles, or once to play on interaction.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "off" |
| Accepted option IDs | "off", "loop", "once" |
| NPC kinds | "pokemon" |
pokemon_pose¶
Base Pose or Animation
Choose an available pose. The default ground_idle switches to ground_walk while the NPC walks.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "ground_idle" |
| NPC kinds | "pokemon" |
pokemon_custom_pose¶
Custom Pose
Enable the 3D editor for adjusting the model's bones on top of its base pose.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | false |
| NPC kinds | "pokemon" |
pokemon_parts_json¶
Pokémon 3D Pose
Open the pose editor to change bone position, rotation, scale, and visibility. Requires Custom Pose.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| NPC kinds | "pokemon" |
pokemon_freeze¶
Freeze Animation Frame
Hold the current frame of the base animation. Walking and triggered animations still play normally.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | false |
| NPC kinds | "pokemon" |
pokemon_freeze_time¶
Frame Time (s)
Time in the animation to freeze. Enabling Freeze Animation Frame captures the preview's current frame.
| Property | Value |
|---|---|
| Editor type | NUMBER |
| Editor default | 0 |
| NPC kinds | "pokemon" |
pokemon_hitbox_width¶
Hitbox Width
Width in blocks (0 to 4). Use 0 for the model default. Changes are shown in the preview.
| Property | Value |
|---|---|
| Editor type | NUMBER |
| Editor default | 0 |
| NPC kinds | "pokemon" |
pokemon_hitbox_height¶
Hitbox Height
Height in blocks (0 to 4). Use 0 for the model default. Changes are shown in the preview.
| Property | Value |
|---|---|
| Editor type | NUMBER |
| Editor default | 0 |
| NPC kinds | "pokemon" |
Body¶
breathing¶
Breathing Animation
Animate idle breathing on humanoid NPCs.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | true |
| NPC kinds | "humanoid" |
blink¶
Blinking
Let humanoid NPCs blink.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | true |
| NPC kinds | "humanoid" |
body_rotation¶
Lock Body Rotation
Keep the body facing the direction below instead of turning it toward gaze targets.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | false |
body_lock¶
Allow Head Movement
When body rotation is locked, allow the head to track the targets enabled under Movement.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | false |
body_yaw¶
Facing Direction (degrees)
With body rotation locked, use 0 for south, 90 for west, 180 for north, or -90 for east. Leave blank to keep the current direction.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
pos_x¶
X Position
Saving a new coordinate moves the NPC and its home position.
| Property | Value |
|---|---|
| Editor type | NUMBER |
| Editor default | 0 |
pos_y¶
Y Position
The NPC's height in the world. With gravity disabled it stays at this height.
| Property | Value |
|---|---|
| Editor type | NUMBER |
| Editor default | 0 |
pos_z¶
Z Position
Saving a new coordinate moves the NPC and its home position.
| Property | Value |
|---|---|
| Editor type | NUMBER |
| Editor default | 0 |
no_gravity¶
No Gravity
Keep the NPC at its current height, including in midair.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | false |
fall_protection¶
Fall Protection
Prevent fall damage and return the NPC home after a long fall.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | false |
ignore_hitbox¶
Allow Blocks Inside Hitbox
Allow blocks to be placed inside the NPC's hitbox. Size and interactions are unchanged.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | false |
model_pose¶
Pose
Choose default, sitting, crouching, sleeping, arms_forward, or arms_up.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "default" |
| Accepted option IDs | "default", "sitting", "crouching", "sleeping", "arms_forward", "arms_up" |
| NPC kinds | "humanoid" |
model_parts_json¶
Body Parts
Adjust the position, rotation, scale, and visibility of individual body parts.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| NPC kinds | "humanoid" |
Equipment¶
equip_screen¶
Equipment Editor
Preview the NPC and equip items by clicking or dragging from your inventory.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| NPC kinds | "humanoid" |
equip_head¶
Helmet
Head item ID or JSON. Copy the held item to preserve components such as enchantments and color.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| NPC kinds | "humanoid" |
equip_chest¶
Chestplate
Chest item ID or JSON.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| NPC kinds | "humanoid" |
equip_legs¶
Leggings
Leg item ID or JSON.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| NPC kinds | "humanoid" |
equip_feet¶
Boots
Feet item ID or JSON.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| NPC kinds | "humanoid" |
equip_mainhand¶
Main Hand
Main hand item ID or JSON.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| NPC kinds | "humanoid" |
equip_offhand¶
Off Hand
Off hand item ID or JSON.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| NPC kinds | "humanoid" |
Interaction¶
interaction_mode¶
On Interaction
Use none to do nothing, actions to run actions only, battle to fight, dialog to talk, trade to open the shop, or heal to heal the party.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "none" |
| Accepted option IDs | "none", "actions", "battle", "dialog", "trade", "heal" |
actions_json¶
Actions
Configure actions triggered by interactions, battles, dialogue, trades, or proximity.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
dialogs_json¶
Dialogue
Edit pages, choices, actions, and conditions.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
trades_json¶
Trade Offers
Set item or command rewards, costs, usage limits, and conditions.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
trade_speech¶
Shopkeeper Speech
Show greetings and responses in the shop.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | true |
trade_restock¶
Rotating Stock
At each restock, select offers using their weights and show the time until the next restock.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | false |
trade_restock_minutes¶
Restock Interval (min)
Time between restocks (1 to 10080 minutes). Requires Rotating Stock.
| Property | Value |
|---|---|
| Editor type | NUMBER |
| Editor default | 30 |
trade_restock_count¶
Offers per Restock
Number of offers selected at each restock (1 to 100), up to the number of weighted offers.
| Property | Value |
|---|---|
| Editor type | NUMBER |
| Editor default | 3 |
Dialogue profile¶
portrait_mode¶
Dialogue Portrait
Use npc for the NPC, off to hide the portrait, pokemon for a chosen species, or human for a custom human portrait.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "npc" |
| Accepted option IDs | "npc", "off", "pokemon", "human" |
portrait_position¶
Portrait Position
Use top_right, top_left, bottom_right, or bottom_left. Defaults to top_right.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "top_right" |
| Accepted option IDs | "top_right", "top_left", "bottom_right", "bottom_left" |
portrait_species¶
Portrait Species
Choose the species shown in Pokémon portrait mode.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
portrait_aspects¶
Portrait Aspects and Form
Enter one aspect per line without spaces, such as alolan, female, or cosmetic_item=league.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| List separator | " " |
One aspect per line, without spaces. Examples: alolan, female, cosmetic_item=league.
portrait_shiny¶
Shiny Portrait
Show the Shiny variant in Pokémon portrait mode.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | false |
portrait_skin_type¶
Portrait Skin Source
For human portraits, choose texturepack, url for a PNG link, or player for a Minecraft username.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "texturepack" |
| Accepted option IDs | "texturepack", "url", "player" |
portrait_skin_model¶
Portrait Model
Choose slim or default for URL and resource pack skins. Player skins use their original model.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "slim" |
| Accepted option IDs | "slim", "default" |
portrait_skin¶
Portrait Skin
Enter a skin name or texture ID for texturepack, a direct PNG URL for url, or a Minecraft username for player.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
Animations¶
anim_interact¶
Interaction Animation
Plays when a player interacts with the NPC. Leave blank for no animation.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
anim_battle_start¶
Battle Start Animation
Plays when the battle starts.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
anim_victory¶
NPC Victory Animation
Plays when the NPC wins. Leave blank for the default Cobblemon animation.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
anim_defeat¶
NPC Defeat Animation
Plays when the NPC loses. Leave blank for the default Cobblemon animation.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
anim_idle¶
Idle Animation
Plays periodically outside of battle, such as wave.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
anim_idle_interval_seconds¶
Idle Animation Interval (s)
Time between idle animation plays.
| Property | Value |
|---|---|
| Editor type | NUMBER |
| Editor default | 30 |
Battle¶
enabled¶
Enable Battles
Allow players to battle this NPC.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | true |
battle_intro¶
Battle Introduction
Show both trainers and their teams before battle. Requires GreatNPC on the client.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | true |
battle_intro_seconds¶
Introduction Duration (s)
Show the battle introduction for 1 to 15 seconds. Players can click to skip.
| Property | Value |
|---|---|
| Editor type | NUMBER |
| Editor default | 4 |
team¶
Team
Team ID in trainer_team, such as custom/bt1.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
team_json¶
Team (JSON)
Optional Pokémon list in trainer_team format. Overrides Team when provided.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| Visibility | Hidden in normal field lists |
level_mode¶
Level Mode
Use normal for team levels, relative to scale from the player's highest level, or flat for level 50.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "normal" |
| Accepted option IDs | "normal", "relative", "flat" |
level_offset¶
Level Offset
Add this amount to all NPC Pokémon levels. Negative values are allowed.
| Property | Value |
|---|---|
| Editor type | NUMBER |
| Editor default | 0 |
battle_format¶
Battle Format
Choose single, double, or triple.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "single" |
| Accepted option IDs | "single", "double", "triple" |
allow_format_downgrade¶
Allow Smaller Battle Format
If the NPC lacks enough Pokémon, fall back to a smaller format. The player needs enough usable Pokémon for the resulting format.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | false |
battle_ai¶
Battle AI
Choose rct, random, strong0 through strong5, or generation5.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "rct" |
| Accepted option IDs | "rct", "random", "strong0", "strong1", "strong2", "strong3", "strong4", "strong5", "generation5" |
skill¶
Skill
Cobblemon skill level from 0 to 5. Use -1 to derive it from the AI.
| Property | Value |
|---|---|
| Editor type | NUMBER |
| Editor default | -1 |
battle_theme¶
Battle Music
Sound ID such as cobblemon:battle.pvn.gym_leader.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "cobblemon:battle.pvn.default" |
shuffle_team¶
Shuffle Team
Randomize the NPC team order for each battle.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | false |
MegaShowdown¶
allow_mega¶
Allow Mega Evolution
Allow the NPC to use Mega Evolution and Ultra Burst.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | true |
allow_tera¶
Allow Terastallization
Allow the NPC to Terastallize.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | true |
allow_dynamax¶
Allow Dynamax
Allow the NPC to Dynamax or Gigantamax.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | true |
allow_zmove¶
Allow Z-Moves
Allow the NPC to use Z-Moves.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | true |
Rematches¶
one_battle_per_player¶
One Battle per Player
Each player gets one battle with this trainer. Starting the battle uses the attempt, regardless of the outcome. NPCs sharing a trainer preset share this limit.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | false |
cooldown_in_seconds¶
Rematch Cooldown
The wait begins only when the player wins. Use 0 for no wait. Examples: 30s, 1h, 1h30s, 2d12h. Bare numbers mean seconds.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "0" |
daily_reset¶
Daily Reset (HH:mm)
After a win, the player can rematch at the next occurrence of this server time. Overrides the rematch cooldown. Leave blank to use a duration.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
is_rematch_allowed¶
Allow Rematches
Let each player battle again after defeating this NPC.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | true |
max_victories¶
Maximum Victories
Limit how often each player can defeat the NPC. Use 0 for no limit.
| Property | Value |
|---|---|
| Editor type | NUMBER |
| Editor default | 0 |
Access¶
permission¶
Battle Permission
Permission node required to battle. Leave blank to allow any player.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
required_player_tags¶
Required Player Tags
Enter one tag per line. The player must have every listed tag.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| List separator | "," |
One tag per line (from /tag add). The player must have ALL of them.
forbidden_player_tags¶
Forbidden Player Tags
Enter one tag per line. Any listed tag prevents the player from battling.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| List separator | "," |
One tag per line. Players with ANY of these tags cannot battle.
prerequisite_trainers¶
Prerequisite Trainers
Enter one trainer preset ID per line. The player must defeat every listed trainer first.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| List separator | "," |
One trainer per line (preset ID, e.g. kanto/brock). The player must have defeated all of them.
Player party¶
maximum_party_size¶
Maximum Party Size
Maximum number of Pokémon in the player's party.
| Property | Value |
|---|---|
| Editor type | NUMBER |
| Editor default | 6 |
minimum_party_size¶
Minimum Party Size
Minimum party size. The battle format can impose a higher minimum.
| Property | Value |
|---|---|
| Editor type | NUMBER |
| Editor default | 1 |
maximum_party_level¶
Maximum Pokémon Level
Every Pokémon in the player's party must be at or below this level.
| Property | Value |
|---|---|
| Editor type | NUMBER |
| Editor default | 100 |
minimum_party_level¶
Minimum Pokémon Level
Every Pokémon in the player's party must be at or above this level.
| Property | Value |
|---|---|
| Editor type | NUMBER |
| Editor default | 1 |
Menu¶
menu_visible¶
Show in Trainer Menu
List this trainer in the trainer menu.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | true |
menu_category¶
Menu Category
Group the trainer under a category such as Kanto or Gyms. Leave blank to use the preset folder.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
menu_permission¶
Menu Visibility Permission
Permission node required to see the trainer. Leave blank to show it to everyone. Without a permission manager, level 2 operators have access.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
menu_icon¶
Menu Icon
Item ID such as cobblemon:great_ball. Leave blank for a Poké Ball.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
menu_description¶
Menu Description
Text shown in the trainer menu. Supports & color codes.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
Rewards¶
on_victory_commands¶
Victory Commands
Run after the player wins. Enter one command per line without a leading slash. Use %player% for the player and %trainer% for the NPC.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| List separator | " ;; " |
One command per line, without the leading /. Use %player% (player name) and %trainer% (NPC name). Example: give %player% cobblemon:rare_candy 3
first_victory_commands¶
First Victory Commands
Run only after the player's first victory over this trainer. Enter one command per line without a leading slash. Use %player% for the player and %trainer% for the NPC.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| List separator | " ;; " |
One command per line, without the leading /. Use %player% (player name) and %trainer% (NPC name). Example: give %player% cobblemon:rare_candy 3
on_defeat_commands¶
Defeat Commands
Run after the player loses. Enter one command per line without a leading slash. Use %player% for the player and %trainer% for the NPC.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| List separator | " ;; " |
One command per line, without the leading /. Use %player% (player name) and %trainer% (NPC name). Example: give %player% cobblemon:rare_candy 3
heal_player_before¶
Heal Before Battle
Heal the player's party before the battle starts.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | false |
heal_player_after¶
Heal After Battle
Heal the player's party after the battle ends.
| Property | Value |
|---|---|
| Editor type | BOOLEAN |
| Editor default | false |
Messages¶
intro_message¶
Intro Message
Sent to the player when battle starts. Supports & color codes, %player%, and %trainer%.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
victory_message¶
Victory Message
Sent to the player when they win. Supports & color codes, %player%, and %trainer%.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
defeat_message¶
Defeat Message
Sent to the player when they lose.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
broadcast_victory¶
Victory Announcement
Broadcast when a player wins, for example &6%player% defeated %trainer%!
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
Required restrictions¶
required_type¶
Required Types
The party must cover every listed entry. Separate types with commas. Use a slash for a dual type (fire/flying). Supports * and +.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| List separator | "," |
required_label¶
Required Labels
The party must cover every listed entry. Separate Cobblemon labels with commas, such as legendary and mythical.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| List separator | "," |
required_pokemon¶
Required Pokémon
The party must cover every listed entry. Separate species with commas. Add a form after a colon, such as raichu:alolan.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| List separator | "," |
required_held_item¶
Required Held Items
The party must cover every listed entry. Separate item IDs with commas, such as leftovers or cobblemon:choice_band.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| List separator | "," |
required_ability¶
Required Abilities
The party must cover every listed entry. Separate abilities with commas.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| List separator | "," |
required_move¶
Required Moves
The party must cover every listed entry. Separate moves with commas.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| List separator | "," |
Banned restrictions¶
forbidden_type¶
Forbidden Types
No Pokémon in the party may match a listed entry. Separate types with commas. Use a slash for a dual type (fire/flying). Supports * and +.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| List separator | "," |
forbidden_label¶
Forbidden Labels
No Pokémon in the party may match a listed entry. Separate Cobblemon labels with commas, such as legendary and mythical.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| List separator | "," |
forbidden_pokemon¶
Forbidden Pokémon
No Pokémon in the party may match a listed entry. Separate species with commas. Add a form after a colon, such as raichu:alolan.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| List separator | "," |
forbidden_held_item¶
Forbidden Held Items
No Pokémon in the party may match a listed entry. Separate item IDs with commas, such as leftovers or cobblemon:choice_band.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| List separator | "," |
forbidden_ability¶
Forbidden Abilities
No Pokémon in the party may match a listed entry. Separate abilities with commas.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| List separator | "," |
forbidden_move¶
Forbidden Moves
No Pokémon in the party may match a listed entry. Separate moves with commas.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| List separator | "," |
Allowed restrictions¶
allowed_type¶
Allowed Types
If set, every Pokémon in the party must match the list. Separate types with commas. Use a slash for a dual type (fire/flying). Supports * and +.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| List separator | "," |
allowed_label¶
Allowed Labels
If set, every Pokémon in the party must match the list. Separate Cobblemon labels with commas, such as legendary and mythical.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| List separator | "," |
allowed_pokemon¶
Allowed Pokémon
If set, every Pokémon in the party must match the list. Separate species with commas. Add a form after a colon, such as raichu:alolan.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| List separator | "," |
allowed_held_item¶
Allowed Held Items
If set, every Pokémon in the party must match the list. Separate item IDs with commas, such as leftovers or cobblemon:choice_band.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| List separator | "," |
allowed_ability¶
Allowed Abilities
If set, every Pokémon in the party must match the list. Separate abilities with commas.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| List separator | "," |
allowed_move¶
Allowed Moves
If set, every Pokémon in the party must match the list. Separate moves with commas.
| Property | Value |
|---|---|
| Editor type | TEXT |
| Editor default | "" |
| List separator | "," |