Preset JSON fields¶
This table is generated from the serialized fields and declared defaults in TrainerPreset.java. It describes files under config/greatnpc/trainer_preset/, not the global settings.json format.
Omitted fields use the declared defaults below. A syntactically valid field can still require a valid species, item, sound, team, permission, or resource on your server. Run /gnpc validate after editing.
Do not copy editor string encodings into file-based list fields: actions, dialogs, trades, model_parts, and team requirements are real JSON arrays in preset files.
Related schemas: Teams, Actions, Conditions, Dialogue, Trading, and Appearance.
Serialized fields (141)¶
| JSON field | Type | Declared default |
|---|---|---|
team |
string | "" |
display_name |
string | "" |
level_mode |
string | "normal" |
battle_format |
string | "single" |
battle_ai |
string | "generation5" |
battle_theme |
string | "cobblemon:battle.pvn.default" |
entity_uuid |
string | null |
texture |
string | "cobblemontrainerbattle:textures/entity/trainer/slim/red_piikapiika.png" |
on_victory_commands |
array | [] |
on_defeat_commands |
array | [] |
cooldown_in_seconds |
integer | 0 |
is_spawn_allowed |
boolean | false |
one_battle_per_player |
boolean | false |
is_rematch_allowed |
boolean | true |
maximum_party_size |
integer | 6 |
minimum_party_size |
integer | 1 |
maximum_party_level |
integer | 100 |
minimum_party_level |
integer | 1 |
required_type |
array | [] |
required_label |
array | [] |
required_pokemon |
array | [] |
required_held_item |
array | [] |
required_ability |
array | [] |
required_move |
array | [] |
forbidden_type |
array | [] |
forbidden_label |
array | [] |
forbidden_pokemon |
array | [] |
forbidden_held_item |
array | [] |
forbidden_ability |
array | [] |
forbidden_move |
array | [] |
allowed_type |
array | [] |
allowed_label |
array | [] |
allowed_pokemon |
array | [] |
allowed_held_item |
array | [] |
allowed_ability |
array | [] |
allowed_move |
array | [] |
team_inline |
array | null |
enabled |
boolean | true |
daily_reset |
string | "" |
permission |
string | "" |
prerequisite_trainers |
array | [] |
max_victories |
integer | 0 |
level_offset |
integer | 0 |
skill |
integer | -1 |
shuffle_team |
boolean | false |
render_scale |
number | 1.0 |
hide_name_tag |
boolean | false |
first_victory_commands |
array | [] |
heal_player_before |
boolean | false |
heal_player_after |
boolean | false |
intro_message |
string | "" |
victory_message |
string | "" |
defeat_message |
string | "" |
broadcast_victory |
string | "" |
npc_kind |
string | "humanoid" |
battle_intro |
boolean | true |
battle_intro_seconds |
integer | 4 |
battle_intro_reveal |
string | "team" |
body_lock |
boolean | false |
body_rotation |
boolean | false |
no_gravity |
boolean | false |
ignore_hitbox |
boolean | false |
fall_protection |
boolean | false |
name_transparent |
boolean | false |
shadow |
boolean | true |
breathing |
boolean | true |
blink |
boolean | true |
hitbox_width |
number | 0.0 |
hitbox_height |
number | 0.0 |
hitbox_follow_pose |
boolean | true |
show_level_label |
boolean | false |
light_level |
integer | -1 |
level_label |
string | "10" |
portrait_mode |
string | "npc" |
portrait_position |
string | "top_right" |
portrait_species |
string | "" |
portrait_aspects |
string | "" |
portrait_shiny |
boolean | false |
portrait_skin |
string | "" |
portrait_skin_type |
string | "texturepack" |
portrait_skin_model |
string | "slim" |
shiny_particles |
boolean | true |
shiny_sound |
string | "off" |
see_distance |
number | 15.0 |
body_yaw |
string | "" |
model_pose |
string | "default" |
model_parts |
array | [] |
equip_head |
string | "" |
equip_chest |
string | "" |
equip_legs |
string | "" |
equip_feet |
string | "" |
equip_mainhand |
string | "" |
equip_offhand |
string | "" |
interaction_mode |
string | "battle" |
actions |
array | [] |
dialogs |
array | [] |
trades |
array | [] |
trade_speech |
boolean | true |
trade_restock |
boolean | false |
trade_restock_minutes |
integer | 30 |
trade_restock_count |
integer | 3 |
pokemon_species |
string | "" |
pokemon_aspects |
string | "" |
pokemon_shiny |
boolean | false |
pokemon_pose |
string | "ground_idle" |
pokemon_custom_pose |
boolean | false |
pokemon_parts |
array | [] |
pokemon_freeze |
boolean | false |
pokemon_freeze_time |
number | 0.0 |
pokemon_hitbox_width |
number | 0.0 |
pokemon_hitbox_height |
number | 0.0 |
anim_interact |
string | "" |
anim_battle_start |
string | "" |
anim_victory |
string | "" |
anim_defeat |
string | "" |
anim_idle |
string | "" |
anim_idle_interval_seconds |
integer | 30 |
look_at_players |
boolean | true |
look_around |
boolean | false |
look_at_mobs |
boolean | false |
look_at_npcs |
boolean | false |
movable |
boolean | false |
can_walk |
boolean | false |
wander_radius |
number | 5.0 |
wander_interval_seconds |
string | "10" |
return_home_seconds |
integer | 60 |
walk_speed |
number | 0.5 |
allow_mega |
boolean | true |
allow_tera |
boolean | true |
allow_dynamax |
boolean | true |
allow_zmove |
boolean | true |
menu_visible |
boolean | true |
menu_category |
string | "" |
menu_permission |
string | "" |
menu_icon |
string | "" |
menu_description |
string | "" |
allow_format_downgrade |
boolean | false |
required_player_tags |
array | [] |
forbidden_player_tags |
array | [] |
skin_type |
string | "texturepack" |
skin_model |
string | "slim" |
Accepted legacy aliases¶
is_spawn_allowedalso acceptsis_spawning_allowed.
Important defaults¶
enabledis true in a bare preset; a freshly placed spawn-egg NPC deliberately starts with battles disabled.is_spawn_allowedis a compatibility field, not an automatic NPC spawning scheduler.- The declared
texturedefault refers to a legacy resource path. Select a valid skin for your installation rather than assuming the legacy texture is bundled. generation5is an AI identifier; see Teams and AI for the implementation and fallback behavior.team_inlinedefaults to null. The file loader still requiresteamto resolve to an existing external team file, even when inline data is present. A dialogue/shop preset can reference a team file containing[]; a trainer needs a usable team before battling.