English:

Unique Structure Limits is a Forge mod for Minecraft 1.20.1 that lets you control how many times each structure can generate in a world.

This mod was created for large modpacks with many structure mods, where world generation can become heavy and repeated structures can cause lag, especially when many different mods are trying to generate cities, towers, lighthouses, bunkers, boats, ruins, or custom structures.

It was also designed to improve exploration. In large modpacks, it can be frustrating to find the same structure many times while never seeing other structures that are also part of the pack. Unique Structure Limits helps create more variety by limiting repeated structures, so every discovery feels more unique and different from the last one.

The mod tracks generated structures per world and prevents extra copies once the configured limit is reached.

Main features:

- Limit each structure globally per world.
- Set structures to generate only once, multiple times, never, or without limit.
- Works with vanilla and modded structures.
- Helps reduce unnecessary repeated structure generation.
- Helps improve structure variety during exploration.
- Stores world-specific structure data inside the save folder.
- Includes commands to list, find, reload, register, and diagnose structures.
- Supports manual search radius with /usl find.
- Provides TAB suggestions for configured structures.
- Can sync disabled structures from Structurify.
- Includes /usl perf for quick diagnostics.
- Designed for Forge 1.20.1 and Java 17.

Configuration:

The global config file is:

config/unique_structure_limits.cfg

Values:

- -1 = unlimited, USL ignores the structure.
- 0 = blocked, the structure will not generate.
- 1 = only one copy per world.
- 2 or more = maximum number of copies allowed per world.

Example:

default_limit = 1

[fishermans_haven]
lighthouse = 1

[the_lost_city]
city = 1
lighthouse = 1

[minecraft]
ancient_city = 0

World data:

Each world stores its own generated structure data here:

saves/<world>/data/unique_structure_limits.dat

This file remembers which structures were already generated in that world, so the limits remain consistent after restarting the game.

Structurify support:

If Structurify is installed, Unique Structure Limits can read:

config/structurify.json

When a structure is marked as:

"is_disabled": true

USL can automatically treat it as limit 0 in its own config. This helps keep both configs synchronized and prevents disabled structures from appearing in USL suggestions or searches.

Commands:

/usl
Shows the current status of tracked structures.

/usl list
Lists configured and tracked structures.

/usl reload
Reloads the config.

/usl find <structure> <radius>
Searches for a configured structure using a manual radius.

/usl registerhere <structure>
Manually registers a structure at your current location.

/usl perf
Shows a quick diagnostic summary of the mod.

Performance note:

This mod was made with optimization in mind, especially for heavy modpacks with many structure mods. For real CPU profiling, Spark is recommended. The /usl perf command is only a quick diagnostic tool for Unique Structure Limits, while Spark can measure actual server performance.

Recommended setup:

- Minecraft 1.20.1
- Forge 47.4.10
- Java 17
- Optional: Structurify
- Optional: Spark for profiling

Español:

Unique Structure Limits es un mod para Forge 1.20.1 que permite controlar cuántas veces puede generarse cada estructura en un mundo.

Este mod fue creado para modpacks grandes con muchos mods de estructuras, donde la generación del mundo puede volverse pesada y las estructuras repetidas pueden generar lag, especialmente cuando muchos mods intentan generar ciudades, torres, faros, bunkers, barcos, ruinas o estructuras personalizadas.

También fue pensado para mejorar la exploración. En modpacks grandes puede ser frustrante encontrar muchas veces la misma estructura y nunca llegar a ver otras estructuras que también forman parte del pack. Unique Structure Limits ayuda a crear más variedad, limitando las estructuras repetidas para que cada descubrimiento se sienta más único y diferente al anterior.

El mod registra las estructuras generadas por mundo y evita que aparezcan copias extra cuando se alcanza el límite configurado.

Características principales:

- Limita cada estructura de forma global por mundo.
- Permite que una estructura se genere una vez, varias veces, nunca o sin límite.
- Funciona con estructuras vanilla y estructuras de mods.
- Ayuda a reducir generación repetida innecesaria.
- Ayuda a mejorar la variedad de estructuras durante la exploración.
- Guarda datos específicos dentro de cada mundo.
- Incluye comandos para listar, buscar, recargar, registrar y diagnosticar estructuras.
- Permite usar radio manual con /usl find.
- Incluye sugerencias con TAB para estructuras configuradas.
- Puede sincronizar estructuras desactivadas desde Structurify.
- Incluye /usl perf para diagnóstico rápido.
- Diseñado para Forge 1.20.1 y Java 17.

Configuración:

El archivo global de configuración es:

config/unique_structure_limits.cfg

Valores:

- -1 = ilimitada, USL ignora esa estructura.
- 0 = bloqueada, la estructura no se generará.
- 1 = solo una copia por mundo.
- 2 o más = cantidad máxima de copias permitidas por mundo.

Ejemplo:

default_limit = 1

[fishermans_haven]
lighthouse = 1

[the_lost_city]
city = 1
lighthouse = 1

[minecraft]
ancient_city = 0

Datos del mundo:

Cada mundo guarda sus propios datos de estructuras generadas en:

saves/<world>/data/unique_structure_limits.dat

Este archivo recuerda qué estructuras ya fueron generadas en ese mundo, para que los límites se mantengan incluso después de reiniciar el juego.

Soporte para Structurify:

Si Structurify está instalado, Unique Structure Limits puede leer:

config/structurify.json

Cuando una estructura está marcada como:

"is_disabled": true

USL puede tratarla automáticamente como límite 0 en su propia configuración. Esto ayuda a mantener ambas configuraciones sincronizadas y evita que las estructuras desactivadas aparezcan en las sugerencias o búsquedas de USL.

Comandos:

/usl
Muestra el estado actual de las estructuras registradas.

/usl list
Lista las estructuras configuradas y registradas.

/usl reload
Recarga la configuración.

/usl find <estructura> <radio>
Busca una estructura configurada usando un radio manual.

/usl registerhere <estructura>
Registra manualmente una estructura en tu ubicación actual.

/usl perf
Muestra un diagnóstico rápido del mod.

Nota de rendimiento:

Este mod fue creado pensando en la optimización, especialmente para modpacks pesados con muchos mods de estructuras. Para medir CPU real se recomienda usar Spark. El comando /usl perf es solo un diagnóstico rápido de Unique Structure Limits, mientras que Spark permite medir el rendimiento real del servidor.

Configuración recomendada:

- Minecraft 1.20.1
- Forge 47.4.10
- Java 17
- Opcional: Structurify
- Opcional: Spark para análisis de rendimiento

Unique Structure Limits (VIVI2)