`AdminBraziers` is a decorative utility mod for Vintage Story 1.22.x.
It adds always-burning metal braziers and fire cages intended for server-managed areas such as spawn towns, public roads, markets, inns, temples, arenas, and protected settlements.
The mod is especially useful when server staff want permanent atmospheric light sources without having to refill fuel manually.
The package includes:
- Small metal braziers
- Large fire cages
- Scrap, copper, black bronze, iron, meteoric iron, and steel variants
- A server config file: `adminbraziers.json`
- Optional admin-only behavior for survival servers
## Admin Mode
The mod includes a configurable admin mode:
- `adminMode`: enables admin-oriented behavior.
- `removeCraftingRecipesWhenAdminModeEnabled`: removes survival crafting recipes when admin mode is enabled.
- `adminPrivileges`: privileges that count as admin when recipes are kept but admin mode remains enabled.
With the default configuration, players cannot craft these braziers in survival. Server staff can still place them using creative mode, `/give`, WorldEdit, or other admin tooling.
By default, the admin privilege check uses `root`, which matches the vanilla `admin` role.
## Relationship With Braziers
This mod is based on the original `Braziers` mod:
https://mods.vintagestory.at/braziers
The original mod adds decorative permanent braziers and fire cages.
`AdminBraziers` keeps that decorative use case but focuses on server-managed areas. It adds a separate mod identity, a separate asset domain, and configuration to make these blocks admin-only by removing survival crafting recipes when desired.
Use the original mod if you want normal decorative braziers available to players through survival crafting. Use `AdminBraziers` if you want staff-controlled permanent braziers for public or protected server builds.
## Important Notes
- The mod must be installed on both server and clients because it adds blocks and assets.
- It is not server-side only.
- It is designed for admin-built decorative areas, not as a realism-focused survival item.
- Recipe changes require a server restart after editing the configuration.
## Usage Instructions
1. Install the mod on both server and clients.
2. Start the server once to generate `ModConfig/adminbraziers.json`.
3. Keep `adminMode` enabled if the braziers should be admin-only.
4. Restart the server after changing recipe-related configuration.
5. Place the braziers manually in server-managed areas.
Example configuration:
```json
{
"adminMode": true,
"removeCraftingRecipesWhenAdminModeEnabled": true,
"adminPrivileges": [
"root"
]
}
```
Compatibility:
## Credits
- Author: `spasmos`
- Contributors: `Digitalr (Just_a_cat)`, `DazPrinzip`
- Based on the original `Braziers` mod
## Changelog 1.0.0
- First release as `AdminBraziers`
- Renamed the project and mod identity to avoid confusion with the original mod
- Added explicit relationship notes for the original `Braziers` mod
- Added `adminbraziers.json` configuration
- Added optional admin-only mode by removing survival crafting recipes
- Kept the decorative permanent brazier and fire cage use case
Español
`AdminBraziers` es un mod decorativo y utilitario para Vintage Story 1.22.x.
Añade braseros y jaulas de fuego metalicas siempre encendidas, pensadas para zonas gestionadas por el servidor como ciudades iniciales, caminos publicos, mercados, posadas, templos, arenas y asentamientos protegidos.
El mod es especialmente util cuando el equipo de administracion quiere fuentes de luz atmosfericas permanentes sin tener que recargar combustible manualmente.
El paquete incluye:
- Braseros metalicos pequeños
- Jaulas de fuego grandes
- Variantes de chatarra, cobre, bronce negro, hierro, hierro meteorico y acero
- Un archivo de configuracion de servidor: `adminbraziers.json`
- Comportamiento opcional solo para administradores en servidores survival
## Modo Admin
El mod incluye un modo admin configurable:
- `adminMode`: activa el comportamiento orientado a administradores.
- `removeCraftingRecipesWhenAdminModeEnabled`: elimina las recetas survival cuando el modo admin esta activado.
- `adminPrivileges`: privilegios que cuentan como admin si las recetas se mantienen pero el modo admin sigue activado.
Con la configuracion por defecto, los jugadores no pueden fabricar estos braseros en survival. El equipo del servidor puede seguir colocandolos usando modo creativo, `/give`, WorldEdit u otras herramientas de administracion.
Por defecto, la comprobacion de permisos usa `root`, que coincide con el rol vanilla `admin`.
## Relacion con Braziers
Este mod esta basado en el mod original `Braziers`:
https://mods.vintagestory.at/braziers
El mod original añade braseros y jaulas de fuego decorativas permanentes.
`AdminBraziers` mantiene ese uso decorativo, pero se centra en zonas gestionadas por el servidor. Añade una identidad de mod separada, un dominio de assets separado y configuracion para convertir estos bloques en elementos solo para administradores eliminando las recetas survival cuando se desee.
Usa el mod original si quieres braseros decorativos normales disponibles para los jugadores mediante crafteo survival. Usa `AdminBraziers` si quieres braseros permanentes controlados por el staff para construcciones publicas o protegidas del servidor.
## Notas Importantes
- El mod debe instalarse tanto en el servidor como en los clientes porque añade bloques y assets.
- No es un mod solo server-side.
- Esta pensado para zonas decorativas creadas por administradores, no como un item survival orientado al realismo.
- Los cambios de recetas requieren reiniciar el servidor despues de editar la configuracion.
## Instrucciones de Uso
1. Instala el mod en el servidor y en los clientes.
2. Arranca el servidor una vez para generar `ModConfig/adminbraziers.json`.
3. Manten `adminMode` activado si los braseros deben ser solo para administradores.
4. Reinicia el servidor despues de cambiar opciones relacionadas con recetas.
5. Coloca los braseros manualmente en zonas gestionadas por el servidor.
Ejemplo de configuracion:
```json
{
"adminMode": true,
"removeCraftingRecipesWhenAdminModeEnabled": true,
"adminPrivileges": [
"root"
]
}
```
Compatibilidad:
## Creditos
- Autor: `spasmos`
- Contribuidores: `Digitalr (Just_a_cat)`, `DazPrinzip`
- Basado en el mod original `Braziers`
## Changelog 1.0.0
- Primera release como `AdminBraziers`
- Renombrada la identidad del proyecto y del mod para evitar confusion con el mod original
- Añadidas notas explicitas de relacion con el mod original `Braziers`
- Añadido el archivo de configuracion `adminbraziers.json`
- Añadido modo opcional solo para administradores eliminando las recetas survival
- Conservado el uso decorativo de braseros y jaulas de fuego permanentes