README.es.md
Rama main · réplica de lectura del repositorio original.
# Kuso Physics
<p align="right">
<a href="./README.md" style="margin-right: 10px;">English</a>
<a href="./README.ja.md" style="margin-right: 10px;">日本語</a>
<a href="./README.zh-TW.md" style="margin-right: 10px;">繁體中文</a>
<a href="./README.zh.md" style="margin-right: 10px;">简体中文</a>
<a href="./README.fr.md" style="margin-right: 10px;">Français</a>
<a href="./README.es.md">Español</a>
</p>
<img src="docs/kuso-physics-logo.png" alt="Logo de Kuso Physics" width="200" height="200" align="right" style="margin-left: 20px;"/>
Kuso Physics es un juego de puzles basado en la física en el que guías una pelota hasta su destino manipulando el entorno y aplicando conceptos físicos reales como la gravedad, la fricción y el impulso.
DEMO: https://kusogames.github.io/Kuso-Physics/
<!--  -->
<img src="docs/banner.png" alt="Banner de Kuso Physics" width="420" height="auto" align="left" style="margin-right: 20px;"/>
---
## ¿Qué es Kuso Physics?
Kuso Physics pone a prueba a los jugadores con niveles ingeniosos y un movimiento realista de la pelota. Con el modo Sacudida (agitando el dispositivo o moviendo el ratón) se influye en la trayectoria de la pelota para resolver puzles de física.
---
## Primeros pasos (para desarrolladores)
Es un juego que puedes alojar tú mismo, hecho con Next.js y tecnologías web modernas.
```bash
git clone https://github.com/KusoGames/Kuso-Physics.git
cd Kuso-Physics
npm install
npm run dev
````
Esto prepara un entorno de desarrollo local.
Después puedes jugar en `http://localhost:3000`.
## Autoalojamiento y despliegue con un clic
¡Puedes hacer un fork de este repositorio y ejecutar el juego en tu propio entorno con facilidad!
### 1. Haz un fork en GitHub
[](https://github.com/KusoGames/Kuso-Physics/fork)
Tras el fork, GitHub Actions compila y despliega el sitio automáticamente.
Luego ve a Settings > Pages de tu repositorio y publica la rama `gh-pages`.
---
### 2. Despliegue con un clic en Vercel
[](https://vercel.com/import/project?template=https://github.com/KusoGames/Kuso-Physics)
Si tienes una cuenta de Vercel, despliega el proyecto con un solo clic.
---
## Cómo jugar
1. Lanza la pelota: pulsa el botón Start para empezar la simulación.
2. Guía la pelota: agita el dispositivo o mueve el ratón para aplicar fuerza.
3. Llega a la meta: lleva la pelota hasta el anillo rojo para ganar.
4. Reinicia si hace falta: pulsa Reset para volver a intentar el nivel.
---
## Controles
### Móvil
- Agita el dispositivo para aplicar fuerza (modo Sacudida)
- Toca la pantalla para Start, Reset, zoom y desplazamiento
### Ordenador
- Mueve el ratón rápidamente para aplicar fuerza
- Haz clic y arrastra para girar, usa la rueda para hacer zoom
---
## Modos de juego
- Modo campaña: niveles seleccionados que introducen nuevas mecánicas
- Niveles personalizados: juega o comparte niveles creados por usuarios
- Editor de niveles: crea y publica tus propios puzles
---
## Trucos y consejos
- Aprovecha el impulso en las pendientes
- Las superficies que rebotan más (rosa/morado) te ayudan a ganar altura
- Sacudidas suaves = más precisión
- Estudia el diseño del nivel antes de lanzar
- En el juego hay artículos de física para entenderlo mejor
---
## Preguntas frecuentes
- P: ¿El modo Sacudida no funciona?
R: Asegúrate de haber activado los permisos de movimiento o prueba con un navegador de escritorio.
- P: ¿Puedo guardar y compartir niveles?
R: ¡Sí! Usa el editor de niveles y compártelos con un código o un enlace.
- P: ¿Se puede jugar sin conexión?
R: La mayoría de las funciones funcionan sin conexión tras la primera carga.
- P: ¿La pelota se ha atascado?
R: Pulsa Reset y prueba otro enfoque.
---
## Licencia
Kuso Physics tiene licencia AGPL-3.0.
Consulta `LICENSE` para más detalles.
Para una licencia comercial, contacta directamente con el fundador del proyecto.
---
## Aviso de marca
«Kuso Physics» es una marca no registrada del fundador del proyecto y forma parte de la familia de obras Kuso Games.
> El nombre «Kuso Physics», junto con su logotipo y sus elementos de marca, forma parte esencial de la identidad del proyecto.
> Queda terminantemente prohibido cualquier uso no autorizado que pueda causar confusión, sugerir afiliación o dar a entender el respaldo del proyecto oficial.
Para más información, consulta [`trademarks.md`](./trademarks.md).
---
## Contacto
* Página del proyecto: [https://github.com/KusoGames/Kuso-Physics](https://github.com/KusoGames/Kuso-Physics)
* GitHub Issues: [https://github.com/KusoGames/Kuso-Physics/issues](https://github.com/KusoGames/Kuso-Physics/issues)
- Para preguntas, sugerencias o informes de errores: usa [https://github.com/KusoGames/Kuso-Physics/discussions](https://github.com/KusoGames/Kuso-Physics/discussions)
---
¡Disfruta del caos de la física!