Software INIfier

INIfier le permite reemplazar el contenido de Unity TextAsset sin actualizar/reemplazar los propios archivos de recursos. Esto es principalmente útil para los desarrolladores que necesitan reemplazar TextAssets como parte de sus modificaciones, y no está destinado a los usuarios finales. Sin embargo, todavía puede ser útil para los usuarios, por ejemplo, si TextAsset almacena texto que les gustaría traducir a otro idioma.

Esto generalmente requiere actualizar los archivos .assets en el juego y distribuir archivos actualizados o un parche que puede requerir redesarrollo y distribución con cada nueva actualización del juego. Con INIfier, hasta que el nombre del recurso cambie, puede continuar usando el mismo archivo de reemplazo en cualquier versión del juego. Y hasta que el archivo se sobrescribe o elimina, no es necesario volver a crearlo cada vez que inicie o actualice el juego.

Instalación (para usuarios finales)

Instala Unity Mod Manager para el juego de destino. Agregue un archivo .zip de este mod a Unity Mod Manager. El mod estará activado de forma predeterminada, pero se puede activar o desactivar utilizando el menú UMM en el juego (por defecto es Ctrl + F10 para abrir/cerrar). Si la modificación está habilitada, reemplazará el texto/bytes cada vez que se lean desde TextAsset, si está deshabilitada, entonces el contenido original se devolverá al leer el texto/bytes. Si el texto de TextAsset se almacena en una variable diferente o se almacena en caché en lugar de volver a leerse desde el recurso cada vez, INIfier solo controlará la primera lectura.

Uso (para autores de modificaciones)

Haga referencia al archivo .dll del proyecto para utilizar los métodos INIfier. También se incluye un archivo .xml para proporcionar una entrada inteligente para los métodos disponibles.

Hay 2 maneras de reemplazar un archivo

• Proporcione el archivo .ini para reemplazarlo con el mod para que el usuario pueda colocarlo en el directorio INIfier/Assets
• Registrar el archivo que se va a reemplazar mediante programación

También puede usar INIfier para buscar un archivo encontrado/reemplazado y obtener su contenido. Cuidadosamente utilizado, esto permite que varios mods actualicen el mismo TextAsset, cambiando solo la parte afectada del archivo, en lugar de sobrescribir los cambios anteriores a cada mod.

La cadena o matriz de bytes reemplazada se almacena en el archivo .ini en la carpeta Assets dentro del directorio INIfier mod creado por Unity Mod Manager. Si utiliza métodos INIfier para trabajar con archivos de reemplazo, no tiene que preocuparse por la ubicación real de la carpeta Assets.

El archivo se usará en lugar de las propiedades de texto o bytes de la instancia TextAsset. Cada TextAsset tiene un nombre que debe coincidir con el nombre de archivo de reemplazo. Si el archivo a reemplazar no existe, INIfier creará un archivo .found (pero no sobrescribirá el archivo .found existente) con el mismo nombre que TextAsset y colocará el contenido en él. Dependiendo de si se llama a la propiedad "text" o "bytes", el archivo .found se escribirá como una cadena o como una matriz de bytes. Todos los archivos que utilicen la propiedad "text" se leerán/escribirán en formato UTF8.

Puede agregar un requisito para INIfier al archivo json con la información de modificación. Debe usar un identificador, no un nombre. El identificador debe tener 3 espacios antes (ya que las modificaciones se cargan en orden alfabético, esto ayuda a INIfier a fijar los métodos apropiados antes de que cualquier otra cosa pueda usar TextAsset), así que use la cadena "INIfier-1.0.0"