> For the complete documentation index, see [llms.txt](https://claude.fractalgamestudios.es/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://claude.fractalgamestudios.es/bolas/manual-del-juego/que-se-puede-configurar-y-que-no.md).

# Qué se puede configurar y qué no

La chuleta. Tres niveles: **fácil**, **hay que meterse en el código** y **no existe**.

## 🟢 FÁCIL: cambiar un número en un archivo de configuración

Estos archivos existen **solo para esto**. Abres, cambias el número, guardas. No hay que entender nada más ni tocar ningún otro sitio.

| Quiero cambiar…                                       | Archivo                                                   | Ejemplos de lo que hay dentro                                                                                                                       |
| ----------------------------------------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Cuánta gente cabe en cada modo y cuánto se espera** | `ServerStorage.Data.LobbyConfig`                          | Jugadores mínimos/máximos, segundos de espera, y a qué servidor va cada modo                                                                        |
| **Toda la progresión de armas**                       | `ReplicatedStorage.Shared.WeaponProgressionConfig`        | Experiencia por partida, por eliminación, por victoria; multiplicador por modo; lo que cuesta cada nivel; **qué da cada punto de cada estadística** |
| **El jefe del Boss Fight**                            | `ServerStorage.Classes.Arena.ArenaConfig` → bloque `Boss` | Su vida (10.000), su tamaño (x4), el tamaño de su arma, su color y **qué arma lleva**                                                               |
| **El techo de mejoras de cada arma**                  | `ServerStorage.Data.WeaponData`                           | Cuántos puntos admite cada arma en cada estadística, más su nombre, descripción y color                                                             |
| **El dinero de la zona AFK**                          | `ServerStorage.Data.AFKConfig`                            | Cuántos Dollars por tick y cada cuántos segundos                                                                                                    |
| **Las skins y sus precios**                           | `ReplicatedStorage.Shared.SkinConfig`                     | Añadir una skin nueva, su rareza, su precio y para qué armas vale                                                                                   |
| **Los colores y fuentes de TODA la interfaz**         | `ReplicatedStorage.Front.Shared.Theme`                    | Un solo sitio para el color de marca, los verdes de “bien”, los rojos de “mal”, etc.                                                                |
| **La bola base**                                      | `ServerStorage.Classes.Arena.ArenaConfig`                 | Tamaño de bola por defecto y los 8 colores que se reparten                                                                                          |

> **Regla de oro**: si el número que buscas está en uno de estos archivos, cámbialo tranquilo. Están hechos para tocarse y todo lo demás los lee a ellos.

### Los tres cambios que más se van a querer hacer

1. **“El jefe es imposible”** → `ArenaConfig.Boss`: baja `WeaponScale` (el arma barre menos), cambia `WeaponType`, o baja `Health`.
2. **“Se sube de nivel muy lento / muy rápido”** → `WeaponProgressionConfig`: sube `MatchXP.Base` o baja `XPCurve.Growth`.
3. **“Las partidas tardan mucho en empezar”** → `LobbyConfig`: baja el `Timer` del modo.

## 🟡 HAY QUE METERSE EN EL CÓDIGO: se puede, pero es una constante dentro de un script

Se cambia igual de fácil (es un número al principio del archivo), pero **no es un archivo de configuración**: si te equivocas puedes romper algo.

| Quiero cambiar…                                 | Dónde                                                   | Valor actual                                               |
| ----------------------------------------------- | ------------------------------------------------------- | ---------------------------------------------------------- |
| Cómo va a más cada arma en partida              | `ServerStorage.Classes.WeaponScaling.<Arma>`            | Ej: Espada +1 daño por golpe; Daga +5 giro hasta 490       |
| Cada cuánto puedes golpear al mismo enemigo     | `ServerStorage.Classes.BallSystem.WeaponSystem`         | 0,4 s                                                      |
| El parry y la congelación al golpear            | `WeaponSystem`                                          | Parry cada 0,8 s; congelación 0,3 s                        |
| Cómo se mueven las bolas                        | `ServerStorage.Classes.BallSystem.BallFactory`          | Empiezan a buscar rival a los 3 s, van directas a los 10 s |
| El rescate anti-atasco                          | `BallFactory`                                           | Comprueba cada 2 s, exige 8 pasos de movimiento            |
| Cuánto dura la pantalla de resultados           | `ServerScriptService.Managers.ArenaManager`             | 8 s                                                        |
| Cuánto se espera a un jugador que no carga      | `ServerScriptService.Managers.ArenaMatchController`     | 20 s                                                       |
| Cada cuánto busca rivales la cola global        | `ServerScriptService.Managers.GlobalMatchmakingService` | Cada 3 s; caducan a los 10 min                             |
| A qué distancia salen los carteles de “pulsa E” | Cada `...TerminalController`                            | 12 pasos                                                   |
| El aspecto de esos carteles                     | `ProximityPromptStyler`                                 | Tamaños, colores y animación                               |
| La altura de la cámara en cada modo             | `ArenaManager`                                          | 1v1: 20 · 3v3: 30 · BR y Boss: 40                          |

## 🔵 SE TOCA A MANO EN STUDIO (no es código)

| Quiero cambiar…                                             | Dónde                                                              |
| ----------------------------------------------------------- | ------------------------------------------------------------------ |
| La forma de una arena, sus paredes o dónde aparece la gente | `Workspace.<Modo>` — mover las partes en Studio                    |
| Dónde están las puertas de los modos en la Lobby            | `Workspace.Lobbies`                                                |
| La mesa de mejora, la terminal o el punto AFK               | `Workspace.Lobby.Interactables` / `Workspace.Lobby.AFKTogglePoint` |

> Para añadir una **mesa de mejora nueva** en otro sitio no hace falta tocar código: copia el modelo y ponle la etiqueta `SkillsTerminal` a la parte del libro. Lo mismo con `CustomizationTerminal` para las terminales de aspecto.

## 🔴 NO SE PUEDE: no existe todavía

Esto **no es configurable porque no está hecho**. Si lo quieres, hay que programárlo.

| Cosa                                                                  | Estado                                                                                                                        |
| --------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| **Jugar con amigos (party)**                                          | No existe. No hay ningún sistema de grupo                                                                                     |
| **Comprar con Robux de verdad**                                       | No conectado. En Studio y para fundadores se regala, sin guardar                                                              |
| **Ganar Dollars jugando**                                             | No existe. Las partidas dan 0 Dollars                                                                                         |
| **Combinar objetos en la mesa**                                       | No existe (se dejó fuera a propósito)                                                                                         |
| **Recuperar puntos de habilidad gastados**                            | No existe. Gastar es definitivo                                                                                               |
| **Que los bots progresen**                                            | No existe. Siempre pelean con estadísticas base                                                                               |
| **Tienda, misiones diarias, gamepasses, eventos, ajustes, teleports** | Solo pantallas vacías de “vista en desarrollo”                                                                                |
| **Ver tus propias estadísticas**                                      | Se guardan, pero no hay pantalla que las muestre                                                                              |
| **Nivel de CUENTA (distinto del de arma)**                            | Está a medias y **roto**: la función existe pero llama a cosas que no existen. Hoy no la llama nadie, así que no da problemas |
| **Boss Fight en producción**                                          | Funciona en Studio, pero su servidor no está publicado: fuera de Studio no puede teletransportar                              |

## Dos avisos antes de publicar

1. **Quitar el botón “DarDinero”** de la Lobby: da 100 Dollars por clic a cualquiera. Es de pruebas.
2. **Decidir de dónde sale el dinero.** Ahora mismo la única fuente real es estar quieto en la zona AFK. Es raro que un juego de peleas pague por no jugar.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://claude.fractalgamestudios.es/bolas/manual-del-juego/que-se-puede-configurar-y-que-no.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
