Main Page

MSXGL is a free and open source Game Library wrote in C and targeting MSX computers.

GitHub: https://github.com/aoineko-fr/MSXgl

Get Starting

• What is MSXgl?
• Install and Setup
• Create my first program
  • What to choose before starting?
  • Create a plain ROM
  • Create a mapped ROM
• Sample programs (showcase MSXgl features)
• Code documentation (library source documentation)
• Variables type
• Release | Roadmap (what coming next?)
• Projects
• Help

Modules

Core:

• bios (MSX BIOS)
• clock (RTC)
• dos (MSX-DOS 1 & 2)
• input (Joystick, keyboard and mouse)
• math (Random and fast computation)
• memory (Heap or dynamic allocator)
• print (Display text)
• string
• system (Low-level features)

Graphic:

• vdp (Video chip)
• v9990
• draw
• scroll
• sprite_fx
• tile (Software tiles)

Gameplay:

• game/state (Game states)
• game/menu (Menu)
• game/pawn (Character move, anim, physics and collision)
• game/sequence
• input_manager

Tools:

• crypt (Encryptage)
• debug (debug features)
• dos_mapper
• fsm (Finite-state machine)
• localize (Translation manager)
• tool/disk_save (Save on disk from ROM)
• tool/mem_op (Quick operation on buffer)
• tool/qrcode_tiny (Tiny QR Code generator)
• tool/qrcode (QR Code generator)
• tool/reg (Registers setting)
• tool/sjis (Shift-JIS conversion)

Devices:

• device/joymega (JoyMega)
• device/msx-hid (MSX-HID detection)
• device/ninjatap
• device/pac (SRAM catridge)
• device/paddle (Arkanoid Vaus Paddle)
• device/wavegame (Pico+ WaveGame)

Audio chips:

• psg
• msx-music
• msx-audio
• scc

Audio players:

• arkos/akg_player (Arkos Tracker 2 and 3)
• arkos/akm_player
• arkos/aky_player
• ayfx/ayfx_player
• ndp/ndp_player (NDP driver)
• pcm/pcmenc
• pcm/pcmplay
• pt3/pt3_player (Pro Tracker 3)
• trilo/trilo_scc_player (Trilo Tracker)
• trilo/trilo_fm_player 🚧WIP
• vgm/lvgm_player (Light-VGM)
• vgm/vgm_player
• wyz/wyz_player (WYZ Tracker)
• wyz/wyz_player2

Compression:

• compress (RLEp)
• compress/bitbuster
• compress/bitbuster2
• compress/lz48 (3 unpackers)
• compress/pletter
• compress/zx0 (4 unpackers)
• msxi/msxi_unpack 🚧WIP

Network:

• obsonet 🚧WIP
• unapi_tcp 🚧WIP

Helpers:

• asm (Assembler helper)
• basic_usr (Interface with BASIC)
• color
• core
• extbios (Extended BIOS)
• memory_mapper
• mutex

Build tool

• Target media (ROM, MegaROM, DOS Disk, etc.)
• Build tool (project configuration options)
• Defines
• Emulators

Data

• Font
• Cursor

Tools

• MSXtk (tool kit)
  • MSXbin (binary data convertor)
  • MSXcrypt (encryption tool)
  • MSXhex (binary generator from IHX file)
  • MSXimg (image convertor)
  • MSXmath (precompute table generator)
  • MSXzip (compressor)
• SDCC
• VS Code
• MSX Game Scores

Links

• GitHub repository
• Discord server
• Online documentation
• Resources (about MSXgl and MSX)