Fusion

`merge / replace`

GP-Next ahora tiene dos modos a nivel de archivo para los parches JSON normales:

merge
replace

Si solo quieres recordar una frase:

merge: escribe solo las partes que quieres cambiar
replace: pasas a controlar todo el JSON de ese tipo

Esta pagina esta dedicada a explicar la diferencia entre esos dos modos, como configurarlos y cuando conviene usar cada uno.

Comportamiento por defecto

Por defecto, GP-Next trata los parches JSON normales asi:

features / objects: merge
levels: en la practica, reemplazo de archivo completo
lang: sigue fusionandose en profundidad en MultiLanguage.lyrics
worldmap: usa el sistema runtime propio de GP-Next, no las reglas de esta pagina

Por eso esta pagina se centra sobre todo en:

jsons/features/*.json
jsons/objects/*.json

Que significa `merge`

merge es el enfoque original y por defecto de GP-Next.

Su objetivo es:

conservar la mayor parte posible del JSON original del juego
sobrescribir solo los campos que escribes de forma explicita
mantener los parches pequenos y mas compatibles con futuras actualizaciones

Por ejemplo, si solo quieres cambiar las estadisticas de una planta, merge suele ser la mejor primera opcion.

{
  "objects": [
    {
      "aliases": ["peashooter"],
      "objclass": "PlantProperties",
      "objdata": {
        "SunCost": 50,
        "Cooldown": 2
      }
    }
  ]
}

Este parche no reemplaza todo PlantProps. Solo cambia esos dos campos de peashooter.

Que significa `replace`

replace significa:

GP-Next deja de usar las reglas normales de fusion para ese tipo
tu archivo de parche reemplaza directamente todo el JSON original de ese tipo

Es util cuando:

quieres rehacer por completo el contenido de la tienda
quieres eliminar con claridad una gran cantidad de datos vanilla
no quieres que siga quedando nada del contenido original de ese tipo

Asi que replace no es solo "una sobrescritura mas fuerte". Significa "este tipo completo ahora lo controla mi archivo".

Como configurarlo

Pon el archivo de configuracion aqui:

jsons/config/patching.json

Ejemplo minimo:

{
  "defaultMode": "merge",
  "features": {
    "StoreCommodityFeatures": { "mode": "replace" }
  },
  "objects": {
    "PlantProps": { "mode": "replace" }
  }
}

Esto significa:

los tipos no listados siguen usando merge
StoreCommodityFeatures usa replace completo
PlantProps usa replace completo

Alcance actual

Ahora mismo esta configuracion solo afecta a:

features
objects

Eso significa que archivos como:

features/PlantFeatures.json
features/StoreCommodityFeatures.json
objects/PlantProps.json
objects/ZombieProps.json

pueden cambiarse entre merge y replace mediante patching.json.

Estas categorias no usan las reglas de esta pagina:

levels
lang
worldmap

Reglas de configuracion

Las reglas actuales son simples:

escribe los nombres de tipo dentro de features y objects
los tipos no listados usan defaultMode
si omites defaultMode, se usa merge
por ahora solo se admiten merge y replace

Por ejemplo:

{
  "features": {
    "StoreCommodityFeatures": { "mode": "replace" }
  }
}

Esto cambia solo StoreCommodityFeatures a replace. Todo lo demas mantiene el comportamiento por defecto.

Que hace GP-Next en `merge`

Features

Los archivos Features no se fusionan por indice del array. Se emparejan mediante campos identificadores.

Casos comunes:

la mayoria de archivos Features: CODENAME
MintObtainRoute: Family
StoreCommodityFeatures.Plants / Upgrade: CommodityName

Objects

Los archivos Objects suelen localizar las entradas dentro del array objects por:

aliases[0]

Asi que si editas una planta o un zombi, normalmente escribes su primer alias.

Los arrays requieren cuidado extra

Incluso en merge, los arrays no se fusionan elemento por elemento por indice.

En GP-Next, los arrays siguen reemplazandose completos por defecto.

Esto suele aplicarse a cosas como:

pools de zombis
PLANTS
SEEDCHOOSERDEFAULTORDER
ciertas listas completas de la tienda

Asi que merge no significa "todo se anade automaticamente de forma inteligente". Significa sobre todo que los campos de objeto se fusionan por regla, mientras que los arrays siguen tendiendo al reemplazo.