diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md deleted file mode 100644 index 5614cec..0000000 --- a/.github/copilot-instructions.md +++ /dev/null @@ -1,61 +0,0 @@ -# 🧠 Custom Instructions for GitHub Copilot -**Project Context: Discord Bot + Game System Integration (discord.js 15.0.0-dev.1759363313-f510b5ffa)** - ---- - -## 1. Primary Source of Truth -- Always treat the **installed package** in `node_modules/discord.js` as the *definitive source* of API behavior and typings. -- Do **not** rely solely on public documentation or examples; cross-verify any methods, classes, or type names directly from: - - The source code and declaration files inside `node_modules/discord.js` - - The project’s internal reference file `example.ts.txt` - -> If discrepancies exist, assume `example.ts.txt` and local types reflect the *intended experimental API* for this build. - ---- - -## 2. Secondary Sources -Use these **only when confirmed to still be valid** for the current development version: -- [Discord.js Guide](https://discordjs.guide) -- [discord.js GitHub Repository](https://github.com/discordjs/discord.js) -- [Discord API Types GitHub](https://github.com/discordjs/discord-api-types) -- [Discord Developer Documentation](https://discord.com/developers/docs/intro) - -> ⚠️ Mark explicitly when a snippet or concept originates from official docs and may be outdated. - ---- - -## 3. Code & Type Analysis Scope -Copilot must **investigate, interpret, and reference** the following project directories for all game logic and command definitions: - -- `src/game/**` -- `src/commands/game/**` -- `src/commands/admin/**` - -### Tasks: -- Analyze **all game-related classes, interfaces, and types**, including metadata structures (e.g., `GameAreaLevel`, `GameArea`, `ScheduledMobAttack`, and mission types). -- Identify how these interact with command creation and execution flows. -- Detect **missing type declarations**, inconsistent imports, or unreferenced type usages. -- Evaluate whether metadata in `GameAreaLevel` can safely include additional properties (e.g., `image`, `referenceImage`, or similar) for visual mapping of game areas. -- Verify that all related commands and editors properly support or update those fields. - ---- - -## 4. Appwrite Integration Considerations -While analyzing the above directories, also check for: -- Possible migration paths for mission and attack scheduling logic (`ScheduledMobAttack`, mission trackers) into **Appwrite Functions** or **Appwrite Realtime** for better live synchronization and event-driven execution. -- Type definitions or data structures that may need adaptation for Appwrite’s SDK. - ---- - -## 5. Validation -Before finalizing any generated code or type updates: -- Run TypeScript validation to ensure type correctness: - ```bash - npx tsc --noEmit -``` - -## 6. Communication Protocol -When Copilot suggests or modifies code, it must explicitly indicate the origin of the reference: -- 🟩 node_modules → Authoritative source (preferred) -- 🟦 example.ts.txt → Experimental / confirmed local reference -- 🟨 Official docs → Secondary, possibly outdated source diff --git a/.github/prompts/discord.js-v15-dev.prompt.md b/.github/prompts/discord.js-v15-dev.prompt.md deleted file mode 100644 index 824a870..0000000 --- a/.github/prompts/discord.js-v15-dev.prompt.md +++ /dev/null @@ -1,11 +0,0 @@ -# Prompt: Discord.js 15 Development Mode - -When assisting with Discord.js version `15.0.0-dev.1759363313-f510b5ffa`: - -- Treat the installed code in `node_modules/discord.js` as the primary and most reliable reference. -- Always analyze the file `example.ts.txt` to extract API patterns, since it reflects the intended usage of this dev version. -- Do not rely blindly on official docs or the guide; use them only to compare and note differences with the dev version. -- Highlight when functionality has changed from v14 to v15, based on observed code and `example.ts.txt`. -- Encourage verification by: - ```bash - npx tsc --noEmit diff --git a/.github/prompts/error-strict.prompt.md b/.github/prompts/error-strict.prompt.md deleted file mode 100644 index 350461d..0000000 --- a/.github/prompts/error-strict.prompt.md +++ /dev/null @@ -1,28 +0,0 @@ -# Prompt: TypeScript Strict Error Resolver - -Whenever Copilot generates or modifies code: - -1. **Never ignore compiler errors** like `TS2339`, `TS2345`, or similar. - - Always explain what the error means in plain language. - - Always suggest at least one concrete fix. - -2. **For missing properties or methods (e.g. `TS2339`)**: - - Check if the method exists in the installed `node_modules`. - - If it doesn’t exist, assume the API changed in `discord.js@15-dev`. - - Propose alternatives based on actual available methods (`example.ts.txt` must be consulted). - -3. **For type mismatches (e.g. `TS2345`)**: - - Suggest code changes that handle `null`/`undefined` safely. - - Show how to cast or coerce types **without breaking strict typing**. - -4. **Validation step**: - - Always remind to rerun: - ```bash - npx tsc --noEmit - ``` - until the project compiles cleanly. - - Do not consider the task “done” if compiler errors remain. - -5. **Explicitness**: - - Always specify: “This code suggestion resolves TS2339 / TS2345.” - - Never produce a code snippet that still triggers the same error. diff --git a/.gitignore b/.gitignore index a4479db..0732000 100644 --- a/.gitignore +++ b/.gitignore @@ -1,10 +1,13 @@ +# Dependencias node_modules .env .env.test qodana.yaml -.github -.vscode -.idea +# Carpetas de metadatos/IDE (ancladas a la raíz) +/.github/ +/.vscode/ +/.idea/ -/src/generated/prisma +# Generados +/src/generated/prisma/ diff --git a/.idea/.gitignore b/.idea/.gitignore deleted file mode 100644 index 13566b8..0000000 --- a/.idea/.gitignore +++ /dev/null @@ -1,8 +0,0 @@ -# Default ignored files -/shelf/ -/workspace.xml -# Editor-based HTTP Client requests -/httpRequests/ -# Datasource local storage ignored files -/dataSources/ -/dataSources.local.xml diff --git a/.idea/amayo.iml b/.idea/amayo.iml deleted file mode 100644 index 24643cc..0000000 --- a/.idea/amayo.iml +++ /dev/null @@ -1,12 +0,0 @@ - - - - - - - - - - - - \ No newline at end of file diff --git a/.idea/compiler.xml b/.idea/compiler.xml deleted file mode 100644 index 8ca546d..0000000 --- a/.idea/compiler.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - - - \ No newline at end of file diff --git a/.idea/copilot.data.migration.agent.xml b/.idea/copilot.data.migration.agent.xml deleted file mode 100644 index 4ea72a9..0000000 --- a/.idea/copilot.data.migration.agent.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - - - \ No newline at end of file diff --git a/.idea/copilot.data.migration.ask.xml b/.idea/copilot.data.migration.ask.xml deleted file mode 100644 index 7ef04e2..0000000 --- a/.idea/copilot.data.migration.ask.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - - - \ No newline at end of file diff --git a/.idea/copilot.data.migration.ask2agent.xml b/.idea/copilot.data.migration.ask2agent.xml deleted file mode 100644 index 1f2ea11..0000000 --- a/.idea/copilot.data.migration.ask2agent.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - - - \ No newline at end of file diff --git a/.idea/copilot.data.migration.edit.xml b/.idea/copilot.data.migration.edit.xml deleted file mode 100644 index 8648f94..0000000 --- a/.idea/copilot.data.migration.edit.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - - - \ No newline at end of file diff --git a/.idea/dataSources.xml b/.idea/dataSources.xml deleted file mode 100644 index d43ccdb..0000000 --- a/.idea/dataSources.xml +++ /dev/null @@ -1,12 +0,0 @@ - - - - - sqlite.xerial - true - org.sqlite.JDBC - jdbc:sqlite:$PROJECT_DIR$/prisma/dev.db - $ProjectFileDir$ - - - \ No newline at end of file diff --git a/.idea/discordrp.xml b/.idea/discordrp.xml deleted file mode 100644 index 3a22cc7..0000000 --- a/.idea/discordrp.xml +++ /dev/null @@ -1,9 +0,0 @@ - - - - - \ No newline at end of file diff --git a/.idea/git_toolbox_prj.xml b/.idea/git_toolbox_prj.xml deleted file mode 100644 index 02b915b..0000000 --- a/.idea/git_toolbox_prj.xml +++ /dev/null @@ -1,15 +0,0 @@ - - - - - - - \ No newline at end of file diff --git a/.idea/jsLibraryMappings.xml b/.idea/jsLibraryMappings.xml deleted file mode 100644 index d23208f..0000000 --- a/.idea/jsLibraryMappings.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - - - - \ No newline at end of file diff --git a/.idea/modules.xml b/.idea/modules.xml deleted file mode 100644 index 7af7187..0000000 --- a/.idea/modules.xml +++ /dev/null @@ -1,8 +0,0 @@ - - - - - - - - \ No newline at end of file diff --git a/.idea/vcs.xml b/.idea/vcs.xml deleted file mode 100644 index 94a25f7..0000000 --- a/.idea/vcs.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - - - - \ No newline at end of file diff --git a/.vscode/tasks.json b/.vscode/tasks.json deleted file mode 100644 index ad6e82a..0000000 --- a/.vscode/tasks.json +++ /dev/null @@ -1,33 +0,0 @@ -{ - "version": "2.0.0", - "tasks": [ - { - "label": "Typecheck: tsc --noEmit", - "type": "shell", - "command": "npm", - "args": [ - "run", - "-s", - "tsc", - "--", - "--noEmit" - ] - }, - { - "label": "Typecheck: tsc --noEmit", - "type": "shell", - "command": "npm", - "args": [ - "run", - "-s", - "tsc", - "--", - "--noEmit" - ], - "problemMatcher": [ - "$tsc" - ], - "group": "build" - } - ] -} \ No newline at end of file diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..97e500c --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,21 @@ +# Guía de Contribución + +¡Gracias por tu interés en colaborar con este proyecto! + +Antes de empezar, ten en cuenta lo siguiente: + +1. Este proyecto es solo para fines de investigación y educativos. + - No se aceptarán contribuciones que tengan como objetivo el uso comercial. + +2. Para proponer cambios: + - Haz un **fork** del repositorio. + - Crea una rama con un nombre descriptivo (ejemplo: `fix-bug-voz`). + - Realiza tus cambios y asegúrate de que el código esté comentado y probado. + - Envía un **pull request** al repositorio original. + +3. Todas las contribuciones estarán sujetas a revisión. + - El autor se reserva el derecho de aceptar o rechazar cambios. + +4. Asegúrate de mantener el aviso de autoría y la licencia en tu código. + +¡Tus aportes ayudan a mejorar este proyecto! 🚀 diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..f22a872 --- /dev/null +++ b/LICENSE @@ -0,0 +1,26 @@ +Licencia de Uso No Comercial para Investigación +Copyright (c) 2025 Shnimlz + +Se concede permiso para usar, copiar y distribuir este software con las siguientes condiciones: + +1. El software solo puede ser utilizado con fines de investigación, educativos o personales. + No está permitido su uso en entornos de producción ni con fines comerciales, directos o indirectos, + sin autorización expresa y por escrito del autor. + +2. Queda prohibido declarar, dar a entender o representar que este software fue creado por otra persona + distinta al autor original. + +3. Debe mantenerse este aviso de copyright y licencia en todas las copias + y redistribuciones del software o fragmentos de este. + +4. Este software se proporciona "tal cual", sin garantías de ningún tipo, expresas o implícitas, + incluyendo, pero no limitadas a, garantías de comerciabilidad, idoneidad para un propósito + particular o disponibilidad. + +5. El incumplimiento de estas condiciones revoca inmediatamente el permiso de uso. + +6. Colaboración y contribuciones: + Las contribuciones de terceros son bienvenidas siempre que respeten esta licencia. + Cualquier colaboración debe realizarse mediante solicitudes de cambio (pull requests) + en el repositorio original, sujetas a revisión y aprobación del autor. + diff --git a/README.MD b/README.MD index 5ca8a0e..a9191a6 100644 --- a/README.MD +++ b/README.MD @@ -14,7 +14,9 @@ --- -> 📝 **Nota importante:** Para crear y editar Items, Mobs, Áreas, Niveles y Ofertas con los editores interactivos, consulta la guía: [CREACION_DE_CONTENIDO.md](./CREACION_DE_CONTENIDO.md) +> 📝 **Nota importante:** Favor de leer la licencia: [LICENSE](./LICENSE) + +> 📝 **Nota importante:** Para crear y editar Items, Mobs, Áreas, Niveles y Ofertas con los editores interactivos, consulta la guía: [CREACION_DE_CONTENIDO.md](./README/CREACION_DE_CONTENIDO.md) --- diff --git a/package.json b/package.json index b3d0956..97f378c 100644 --- a/package.json +++ b/package.json @@ -22,7 +22,7 @@ }, "keywords": [], "author": "", - "license": "ISC", + "license": "MIT", "type": "commonjs", "dependencies": { "@google/genai": "1.20.0",