Short:        PICO-8 fantasy console emulator for Amiga 68020+
Author:       Pawel "Juen" Nowak (j@ki.je)
Uploader:     Pawel "Juen" Nowak (j ki je)
Type:         misc/emu
Version:      0.1
Requires:     AmigaOS 2.0+, 68020+, 1 MB Chip RAM, 4 MB Fast RAM recommended
Architecture: m68k-amigaos

Description:

  Amico8 is a PICO-8 fantasy console emulator for Amiga computers with a
  68020 or better processor.  It loads and runs PICO-8 cartridges in
  both text (.p8) and image (.p8.png) format directly from the Amiga
  file system.

  Features:
  - Runs many PICO-8 cartridges (.p8 and .p8.png) without modification
  - Full 128x128 pixel display, 2x scaled to 256x256 via Amiga copper tricks
  - 16-colour PICO-8 palette mapped to Amiga 12-bit hardware palette
  - Joystick (port 2) and keyboard input
  - Mouse support (port 1) for carts that use mouse API
  - Paula audio: triangle, sawtooth, square, pulse, organ, noise waveforms
  - Optional launcher window (GadTools) when no cart is specified
  - Show FPS overlay, nosound and frameskip options
  - AOT (Ahead-of-Time) native code compiler for Lua numeric functions

  Two executables are provided:

    Amico8      ? 68020/030 version, no FPU required.
                  Runs on any Amiga with a 68020 or better.

    Amico8_040  ? 68040/060 version, requires FPU.
                  Takes advantage of 040/060 instruction scheduling.

  Recommended processor: 68060.

  Usage:
    Amico8 [CART] [NOSOUND] [SHOWFPS] [FRAMESKIP <n>]

    CART         Path to a .p8 cartridge file
    NOSOUND      Disable audio
    SHOWFPS      Show frames-per-second overlay
    FRAMESKIP n  Render every n+1 frames (0=off, 1=half, 2=third speed)

    If CART is not given, a launcher window opens where you can select a
    cart via an ASL file requester and set options graphically.

  Limitations:
  - Some newer PICO-8 API calls may not be implemented
  - Sound effects and music play, but advanced effects (vibrato, slide,
    arpeggio) are not yet implemented
	
---

Tested games:

LIST IN PROGRESS BUT CHECK THIS GAMES FIRST!:
Celeste, Celeste 2, Just One Boss, Combopool, Low Knight


---

Code used:

  Lua 5.2 ? scripting engine base
    Copyright (C) 1994-2015 Lua.org, PUC-Rio
    Authors: R. Ierusalimschy, L. H. de Figueiredo, W. Celes
    License: MIT  (http://www.lua.org/license.html)
    The Lua VM and standard libraries form the core of the interpreter.

  z8lua ? PICO-8-compatible Lua fork (from the Zepto-8 project)
    Copyright (C) 2016-2024 Sam Hocevar <sam@hocevar.net>
    License: WTFPL (http://www.wtfpl.net/)
    Source:  https://github.com/samhocevar/zepto8
    z8lua extends Lua 5.2 with PICO-8-specific syntax (short-if, compound
    assignment operators, integer division, fix32 number type, PICO-8 math
    functions).  The file z8lua/lpico8lib.c is taken directly from Zepto-8.

  p8_compress ? PICO-8 cartridge decompression
    Copyright (C) 2014-2022 Lexaloffle Games LLP
    License: MIT
    Decompresses PICO-8 Lua source code from both old ":c:" format and
    modern "pxa" compressed format.

  stb_image ? PNG image loader
    Author: Sean Barrett
    License: MIT / Public Domain
    Source:  https://github.com/nothings/stb
    Used for loading .p8.png cartridge images.

---

Thanks:

  Kempy/Veezya  ? testing
  OlekW200i     ? moral support
  Quad          ? moral support

---

  Amico8 v0.1 ? April 2026
  Pawel "Juen" Nowak
  Contact: j@ki.je or via imp3!