Skip to content

Commit be2d14c

Browse files
JuanCorso-devJuanCorso-dev
committed
Initial commit: jump_blocks plugin v1.0.0
- Plugin de Jump Blocks para Minecraft 1.21.x+ con Java 21 - Configuración simplificada con un solo jump block personalizable - Comando /jumpreload para recargar configuración - Efectos visuales y sonoros personalizables - Sistema anti-spam integrado - Documentación completa con enlaces útiles
0 parents  commit be2d14c

File tree

9 files changed

+837
-0
lines changed

9 files changed

+837
-0
lines changed

‎.gitignore‎

Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
# Gradle
2+
.gradle/
3+
build/
4+
!gradle/wrapper/gradle-wrapper.jar
5+
!**/src/main/**/build/
6+
!**/src/test/**/build/
7+
8+
# Gradle Wrapper
9+
gradle-*/
10+
11+
# IntelliJ IDEA
12+
.idea/
13+
*.iws
14+
*.iml
15+
*.ipr
16+
out/
17+
!**/src/main/**/out/
18+
!**/src/test/**/out/
19+
20+
# Eclipse
21+
.apt_generated
22+
.classpath
23+
.factorypath
24+
.project
25+
.settings
26+
.springBeans
27+
.sts4-cache
28+
bin/
29+
!**/src/main/**/bin/
30+
!**/src/test/**/bin/
31+
32+
# NetBeans
33+
/nbproject/private/
34+
/nbbuild/
35+
/dist/
36+
/nbdist/
37+
/.nb-gradle/
38+
39+
# VS Code
40+
.vscode/
41+
42+
# Mac
43+
.DS_Store
44+
45+
# Windows
46+
Thumbs.db
47+
ehthumbs.db
48+
Desktop.ini
49+
50+
# Logs
51+
*.log
52+
53+
# Temporary files
54+
*.tmp
55+
*.temp
56+
57+
# Plugin distribution (opcional - puedes comentar esta línea si quieres incluir el JAR)
58+
dist/
59+
60+
# Server files (si tienes un servidor de prueba local)
61+
server/
62+
plugins/
63+
world/
64+
world_nether/
65+
world_the_end/
66+
logs/
67+
crash-reports/

‎INSTRUCCIONES.md‎

Lines changed: 232 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,232 @@
1+
# 🚀 jump_blocks - Plugin de Jump Blocks Simplificado
2+
3+
## 📋 Descripción
4+
Plugin modernizado de Jump Blocks para Minecraft 1.21.x+ con Java 21. Sistema de configuración simplificado con un solo jump block personalizable. Por defecto usa Slime Block, pero puedes configurarlo para cualquier bloque que quieras.
5+
6+
## ✨ Características
7+
8+
### 🎯 Jump Block Personalizable
9+
- **Un solo jump block** configurable
10+
- **Slime Block por defecto** (fácil de usar)
11+
- **Cualquier bloque** que quieras configurar
12+
- **Totalmente personalizable** (velocidad, sonidos, partículas)
13+
14+
### 🎨 Efectos Visuales y Sonoros
15+
- **Partículas personalizables** al activar el salto
16+
- **Sonidos únicos** configurables
17+
- **Volumen y tono** ajustables
18+
- **Sistema anti-spam** integrado
19+
20+
### ⚙️ Configuración Simplificada
21+
- **Archivo config.yml** simple y fácil de entender
22+
- **Un solo jump block** configurable
23+
- **Multiplicadores** de velocidad personalizables
24+
- **Cantidad de partículas** ajustable
25+
26+
## 🛠️ Instalación
27+
28+
1. **Descarga** el archivo `jump_blocks-1.0.0.jar`
29+
2. **Coloca** el JAR en la carpeta `plugins/` de tu servidor
30+
3. **Reinicia** el servidor
31+
4. **Configura** el plugin editando `plugins/jump_blocks/config.yml`
32+
33+
## 📁 Estructura de Archivos
34+
35+
```
36+
plugins/
37+
└── jump_blocks/
38+
├── config.yml # Configuración principal
39+
└── jump_blocks-1.0.0.jar
40+
```
41+
42+
## ⚙️ Configuración
43+
44+
### 📝 Archivo config.yml
45+
46+
El plugin crea automáticamente un archivo `config.yml` con la siguiente estructura:
47+
48+
```yaml
49+
# Configuración del jump pad
50+
jump-pad:
51+
material: SLIME_BLOCK
52+
horizontal-multiplier: 1.0
53+
vertical-multiplier: 1.1
54+
sound: ENTITY_SLIME_JUMP
55+
volume: 1.0
56+
pitch: 1.2
57+
particle: CLOUD
58+
particle-count: 10
59+
enabled: true
60+
```
61+
62+
### 🎛️ Opciones de Configuración
63+
64+
| Opción | Descripción | Valores |
65+
|--------|-------------|---------|
66+
| `material` | Bloque que activa el jump pad | Cualquier Material de Minecraft |
67+
| `horizontal-multiplier` | Velocidad horizontal | 0.1 - 5.0 |
68+
| `vertical-multiplier` | Velocidad vertical | 0.1 - 5.0 |
69+
| `sound` | Sonido al activar | Cualquier Sound de Minecraft |
70+
| `volume` | Volumen del sonido | 0.0 - 2.0 |
71+
| `pitch` | Tono del sonido | 0.5 - 2.0 |
72+
| `particle` | Partícula mostrada | Cualquier Particle de Minecraft |
73+
| `particle-count` | Cantidad de partículas | 1 - 100 |
74+
| `enabled` | Habilitar/deshabilitar | true/false |
75+
76+
### 📚 Enlaces Útiles para Configuración
77+
78+
#### **🔧 Documentación Oficial:**
79+
- **Materiales (Bloques):** [Bukkit API - Material](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html)
80+
- **Sonidos:** [Bukkit API - Sound](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html)
81+
- **Partículas:** [Bukkit API - Particle](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Particle.html)
82+
83+
#### **🎮 Wiki de Minecraft (Visual):**
84+
- **Lista de bloques:** [Minecraft Wiki - Blocks](https://minecraft.wiki/w/Block)
85+
- **Lista de sonidos:** [Minecraft Wiki - Sounds](https://minecraft.wiki/w/Sounds)
86+
- **Lista de partículas:** [Minecraft Wiki - Particles](https://minecraft.wiki/w/Particles)
87+
88+
### ✨ Partículas Populares para Jump Pads
89+
90+
| Partícula | Efecto Visual | Recomendado Para |
91+
|-----------|---------------|------------------|
92+
| `CLOUD` | Nube blanca | Jump pads básicos |
93+
| `LAVA` | Partículas de lava | Jump pads de magma |
94+
| `PORTAL` | Partículas púrpuras | Jump pads mágicos |
95+
| `ENCHANT` | Partículas verdes | Jump pads encantados |
96+
| `CRIT` | Partículas doradas | Jump pads críticos |
97+
| `FIREWORK` | Explosión de colores | Jump pads festivos |
98+
| `HEART` | Corazones | Jump pads románticos |
99+
| `VILLAGER_HAPPY` | Partículas verdes | Jump pads felices |
100+
| `EXPLOSION` | Explosión | Jump pads potentes |
101+
| `WATER_SPLASH` | Salpicadura de agua | Jump pads acuáticos |
102+
103+
## 🎮 Uso
104+
105+
1. **Coloca** un bloque configurado (ej: Slime Block)
106+
2. **Camina** sobre el bloque
107+
3. **¡Disfruta** del lanzamiento con efectos!
108+
109+
## 🔧 Comandos
110+
111+
- **`/jumpreload`** - Recarga la configuración del plugin (requiere permiso `jumpblocks.reload`)
112+
- **`/reload`** - Recarga todo el servidor (no recomendado)
113+
- **`/plugins`** - Verifica que el plugin esté cargado
114+
115+
### 📋 Comando `/jumpreload`
116+
117+
**Descripción:** Recarga la configuración del plugin sin reiniciar el servidor
118+
119+
**Uso:** `/jumpreload`
120+
121+
**Permiso:** `jumpblocks.reload`
122+
123+
**Mensajes:**
124+
- ✅ **Verde:** "Configuración recargada exitosamente!" (éxito)
125+
- ❌ **Rojo:** "Error al recargar configuración!" (fallo)
126+
127+
## 📊 Configuración por Defecto
128+
129+
### 🟢 Slime Block (Por Defecto)
130+
- **Velocidad**: Estándar (1.0x horizontal, 1.1x vertical)
131+
- **Sonido**: ENTITY_SLIME_JUMP
132+
- **Partícula**: CLOUD
133+
- **Uso**: Jump pad básico y confiable
134+
135+
## 🎨 Ejemplos de Configuración
136+
137+
### 🟡 Honey Block (Suave)
138+
```yaml
139+
jump-pad:
140+
material: HONEY_BLOCK
141+
horizontal-multiplier: 0.8
142+
vertical-multiplier: 0.9
143+
sound: BLOCK_HONEY_BLOCK_SLIDE
144+
particle: SWEET_BERRY_BUSH
145+
```
146+
147+
### 🔴 Magma Block (Potente)
148+
```yaml
149+
jump-pad:
150+
material: MAGMA_BLOCK
151+
horizontal-multiplier: 1.2
152+
vertical-multiplier: 1.3
153+
sound: BLOCK_LAVA_POP
154+
particle: LAVA
155+
```
156+
157+
### 💚 Emerald Block (Mágico)
158+
```yaml
159+
jump-pad:
160+
material: EMERALD_BLOCK
161+
horizontal-multiplier: 1.3
162+
vertical-multiplier: 1.2
163+
sound: BLOCK_ENCHANTMENT_TABLE_USE
164+
particle: ENCHANT
165+
```
166+
167+
## 🎨 Personalización
168+
169+
### Cambiar el Bloque del Jump Pad
170+
171+
1. **Abre** `config.yml`
172+
2. **Cambia** el valor de `material:` por el bloque que quieras
173+
3. **Ajusta** los otros valores si es necesario
174+
4. **Usa** `/jumpreload` para aplicar cambios (recomendado)
175+
5. **O usa** `/reload` para recargar todo el servidor
176+
177+
Ejemplo para Gold Block:
178+
```yaml
179+
jump-pad:
180+
material: GOLD_BLOCK
181+
horizontal-multiplier: 1.5
182+
vertical-multiplier: 1.2
183+
sound: ENTITY_EXPERIENCE_ORB_PICKUP
184+
volume: 1.0
185+
pitch: 1.0
186+
particle: FIREWORK
187+
particle-count: 15
188+
enabled: true
189+
```
190+
191+
## 🐛 Solución de Problemas
192+
193+
### El plugin no funciona
194+
- ✅ Verifica que esté en la carpeta `plugins/`
195+
- ✅ Reinicia el servidor
196+
- ✅ Revisa la consola por errores
197+
198+
### Los jump pads no se activan
199+
- ✅ Verifica que el bloque esté configurado en `config.yml`
200+
- ✅ Asegúrate de que `enabled: true`
201+
- ✅ Revisa que el material sea correcto
202+
203+
### No se crean archivos de configuración
204+
- ✅ Verifica permisos de escritura en la carpeta `plugins/`
205+
- ✅ Reinicia el servidor
206+
- ✅ Revisa la consola por errores
207+
208+
## 📋 Requisitos
209+
210+
- **Minecraft**: 1.21.x+
211+
- **Java**: 21+
212+
- **Servidor**: Spigot/Paper
213+
- **Gradle**: 8.10+
214+
215+
## 🔄 Actualizaciones
216+
217+
Para actualizar el plugin:
218+
1. **Detén** el servidor
219+
2. **Reemplaza** el JAR antiguo
220+
3. **Inicia** el servidor
221+
4. **Configura** nuevas opciones si es necesario
222+
223+
## 📞 Soporte
224+
225+
Si tienes problemas:
226+
1. **Revisa** la consola del servidor
227+
2. **Verifica** la configuración en `config.yml`
228+
3. **Consulta** este archivo de instrucciones
229+
230+
---
231+
232+
**¡Disfruta de tus Jump Pads personalizados! 🚀**

‎README.md‎

Lines changed: 83 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,83 @@
1+
# 🚀 jump_blocks
2+
3+
Un plugin moderno de Jump Blocks para Minecraft 1.21.x+ desarrollado con Java 21.
4+
5+
## 📋 Descripción
6+
7+
Plugin simplificado que permite configurar un solo tipo de bloque como jump block. Por defecto usa Slime Block, pero es completamente personalizable.
8+
9+
## ✨ Características
10+
11+
- **🎯 Un solo jump block configurable**
12+
- **🎨 Efectos visuales y sonoros personalizables**
13+
- **⚙️ Configuración simplificada**
14+
- **🔄 Comando de recarga sin reiniciar servidor**
15+
- **🚀 Compatible con Java 21 y Minecraft 1.21.x+**
16+
17+
## 🛠️ Instalación
18+
19+
1. Descarga el archivo `jump_blocks-1.0.0.jar`
20+
2. Coloca el JAR en la carpeta `plugins/` de tu servidor
21+
3. Reinicia el servidor
22+
4. Configura el plugin editando `plugins/jump_blocks/config.yml`
23+
24+
## ⚙️ Configuración
25+
26+
El plugin se configura a través del archivo `config.yml`:
27+
28+
```yaml
29+
jump-pad:
30+
material: SLIME_BLOCK
31+
horizontal-multiplier: 1.0
32+
vertical-multiplier: 1.1
33+
sound: ENTITY_SLIME_JUMP
34+
volume: 1.0
35+
pitch: 1.2
36+
particle: CLOUD
37+
particle-count: 10
38+
enabled: true
39+
```
40+
41+
## 🔧 Comandos
42+
43+
- `/jumpreload` - Recarga la configuración del plugin (requiere permiso `jumpblocks.reload`)
44+
45+
## 📚 Enlaces Útiles
46+
47+
- **Documentación Bukkit:** [Material](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html) | [Sound](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html) | [Particle](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Particle.html)
48+
- **Wiki Minecraft:** [Blocks](https://minecraft.wiki/w/Block) | [Sounds](https://minecraft.wiki/w/Sounds) | [Particles](https://minecraft.wiki/w/Particles)
49+
50+
## 🏗️ Desarrollo
51+
52+
### Requisitos
53+
- Java 21+
54+
- Gradle 8.10+
55+
- Spigot API 1.21.1+
56+
57+
### Compilación
58+
```bash
59+
./gradlew clean build
60+
```
61+
62+
### Estructura del Proyecto
63+
```
64+
src/
65+
├── main/
66+
│ ├── java/djkingcraftero/
67+
│ │ └── Main.java
68+
│ └── resources/
69+
│ ├── plugin.yml
70+
│ └── config.yml
71+
```
72+
73+
## 📄 Licencia
74+
75+
Este proyecto es privado y está destinado para uso personal.
76+
77+
## 👨‍💻 Autor
78+
79+
**djkingcraftero**
80+
81+
---
82+
83+
*Plugin desarrollado con ❤️ para la comunidad de Minecraft*

0 commit comments

Comments
 (0)