Short:        PICO-8 fantasy console emulator
Author:       Pawel "Juen" Nowak
Uploader:     Pawel "Juen" Nowak (j ki je)
Type:         misc/emu
Version:      0.3
Requires:     AmigaOS 2.0+/020+, 060 recommended
Architecture: m68k-amigaos >= 2.0

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
  - AOT (Ahead-of-Time) native code compiler for Lua numeric functions
  - BBS

  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 - start with GUI! (recommended)

    or

    Amico8 ?

  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
Undune

For now 2/3 of games will start, 1/3 of games will run ok :)

---

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.

  FAKE-08 - reference PICO-8 implementation
    Author:  Jonathan (jtothebell)
    License: MIT
    Source:  https://github.com/jtothebell/fake-08
    Source code was invaluable for verifying PICO-8 behavior ? API
    semantics, iterator edge cases, metatable setup, _update_buttons
    contract, etc. ? against a known-working C++ reference.  Not used
    in the Amico8 binary, only consulted during development.

---

Thanks:

  Kempy/Veezya, MWB113 - testing
  Quad, OlekW200i, Wozik, Mirq, Borsuk - moral support
  Jonathan (jtothebell) - FAKE-08 reference implementation

---

  Pawel "Juen" Nowak
  Contact: j@ki.je or via imp3!