Skip to content

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_allowed also accepts is_spawning_allowed.

Important defaults

  • enabled is true in a bare preset; a freshly placed spawn-egg NPC deliberately starts with battles disabled.
  • is_spawn_allowed is a compatibility field, not an automatic NPC spawning scheduler.
  • The declared texture default refers to a legacy resource path. Select a valid skin for your installation rather than assuming the legacy texture is bundled.
  • generation5 is an AI identifier; see Teams and AI for the implementation and fallback behavior.
  • team_inline defaults to null. The file loader still requires team to 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.