Valkir Dungeon — licença ======================== Valkir Dungeon é um jogo homebrew para o Game Boy (um jogo novo, feito por um grupo independente de estudantes, não um lançamento comercial), do Equipo Espajoda (Universidade de Alicante, 2026), escrito em assembly RGBDS. A página https://jgdeveloplete.itch.io/valkir-dungeon diz, em espanhol: "Licencia: el código fuente se publica bajo licencia MIT." e "Contenido de terceros: ninguno. El código, los gráficos (tiles 2bpp escritos a mano), los niveles y los efectos de sonido son propios." O CREDITS.md do pacote de fonte (abaixo) repete que tudo é de autoria própria e declara o uso de IA generativa. O que este site serve: a ROM publicada de graça no itch.io do autor (arquivo "ROM de Game Boy", valkir-dungeon.gb), sem alterações, conferida pelo SHA-256, rodando no emulador binjgb. ------------------------------------------------------------------------------ LICENSE (pacote "Código fuente (MIT)" do itch.io) ------------------------------------------------------------------------------ MIT License Copyright (c) 2026 Equipo Espajoda (Universidad de Alicante) Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ------------------------------------------------------------------------------ CREDITS.md (mesmo pacote) ------------------------------------------------------------------------------ # Créditos — Valkir Dungeon **Asignatura:** Razonamiento Automático (Universidad de Alicante) **Proyecto:** Práctica 1, videojuego para Game Boy (DMG-1) en ensamblador (RGBDS) **Equipo:** Espajoda **Licencia:** MIT (ver [`LICENSE`](LICENSE)). Todo lo que hay en este ZIP es 100% de autoría propia. ## Código | Parte | Origen | Notas | |---|---|---| | Bucle principal (`main_loop`), espera al VBLANK y peticiones (`request`) | Propio | El bucle espera a `rLY = 144`, hace lo que toca la VRAM y luego la lógica. Los cambios de sala o de nivel se piden con `request` y se atienden al final del frame. | | DMA de sprites (`DMARoutine`, `hDMARoutine`) y OAM sombra (`shadow_oam`) | Propio, como vimos en clase (Challenge 6) | La rutina se copia a la HRAM al arrancar y se llama en cada VBLANK. | | `memcpy`, `memset`, `call_hl` | Propio, a partir de los challenges 4 y 5 | Igual que las de clase, pero con contador de 16 bits para poder copiar más de 255 bytes. | | Cola de cambios de casilla (`change_tile`, `flush_tiles`) | Propio | Los cambios del mapa se apuntan y se escriben en el VBLANK del frame siguiente. | | Movimiento, colisiones (`check_box`, `overlap`) y objetos | Propio | `overlap` usa el valor absoluto de la resta con `cpl` + `inc`, como las colisiones del Challenge 5. | | Mapa de distancias por BFS (`bfs_step`, `bfs_visit`, `bfs_push`, `flow_dir`) | Propio | Se calcula a trozos (`BFS_BUDGET` casillas por frame) en `bfs_build` y al acabar se copia a `bfs_field`. | | IA de los enemigos (`ai_chase`, `ai_wander`, `ai_archer`, `ai_boss`) | Propio | Se elige con la tabla `AITable` y `call_hl`. | | Números aleatorios (`rng_next`) | Propio | LFSR de 8 bits mezclado con `rDIV`. | | Efectos de sonido (`sfx_shoot`, `sfx_hit`, `sfx_hurt`, `sfx_item`, `sfx_orb`) | Propio | Canal 1 (onda cuadrada con barrido) y canal 4 (ruido). | | Puntuación y récord (`add_score`, `print_score`) | Propio | En decenas, de 0000 a 2550. | | Textos (`print_str`, `char_to_tile`) | Propio | Textos en ASCII; la fuente está en el mismo orden que el ASCII. | ## Gráficos y niveles | Parte | Origen | Notas | |---|---|---| | Tiles del juego, sprites, marcador y fuente (`gfx.inc`) | Propio | Dibujados por nosotros y escritos a mano en pares `DB` (2bpp). | | Salas, enlaces y tabla de niveles (`maps.inc`) | Propio | Las salas están escritas como texto. | | `checkmaps.py` | Propio | Comprueba el tamaño de las salas, los portales y que cada nivel se puede terminar. | | `salas.png` | Propio | Mapa de las 8 salas para el README. | ## Herramientas - RGBDS (`rgbasm`, `rgblink`, `rgbfix`) y el entorno GBTelera de la asignatura. - Emuladores BGB y Emulicious para probar y depurar. ## Sonido No hay ningún fichero de audio ni música de otros. Los 5 efectos (`src/sound.asm`) se generan escribiendo directamente los registros de la APU de la Game Boy (canal 1: onda cuadrada con barrido; canal 4: ruido). ## Inspiración La idea del juego (mazmorra vista desde arriba, generadores de monstruos, llaves y puertas) está inspirada en *Gauntlet* (Atari Games, 1985). No se ha usado nada de su código, gráficos, sonido ni nombre. ## Uso de IA generativa Se ha utilizado asistencia puntual mediante modelos LLM (Claude y ChatGPT) exclusivamente para: - Consultas puntuales sobre sintaxis y directivas del ensamblador RGBDS. - Apoyo en la estructura del script auxiliar en Python (`checkmaps.py`) para verificar la conectividad de los mapas. - Redacción y maquetación de la documentación (README y notas de entrega). Toda la arquitectura, el diseño de niveles, las rutinas de ensamblador (bucle principal, BFS distribuido, colisiones por valor absoluto, DMA en HRAM), los gráficos en formato 2bpp y los efectos de sonido por manipulación directa de registros APU han sido desarrollados íntegramente por los integrantes del equipo siguiendo el temario y los ejercicios de los challenges de la asignatura.