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

  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 [CART] [NOSOUND] [SHOWFPS] [FRAMESKIP <n>]

  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.

---

Thanks:

  Kempy/Veezya  - testing
  Quad, OlekW200i, Wozik, Mirq, Borsuk - moral support

---

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

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[Amiga]                 193897  356088  54.5% -lh5- 6677 Apr 18 06:51 Amico8_v0.2/Amico8
[Amiga]                   1613    3056  52.8% -lh5- 7218 Apr 18 06:50 Amico8_v0.2/Amico8.readme
[Amiga]                 191880  359012  53.4% -lh5- 89a1 Apr 18 06:52 Amico8_v0.2/Amico8_040
[Amiga]                   1269    3161  40.1% -lh5- e8b6 Apr 14 19:23 Amico8_v0.2/games/amico8_demo_demo.p8
[Amiga]                   1223    3448  35.5% -lh5- fc2f Apr 14 19:20 Amico8_v0.2/games/amico8_demo_game.p8
[Amiga]                   2172    5645  38.5% -lh5- 98bc Apr 11 08:33 Amico8_v0.2/games/benchmark.p8
[Amiga]                   1538    3573  43.0% -lh5- afe0 Apr  6 17:23 Amico8_v0.2/games/testinput.p8
[Amiga]                 186525  343596  54.3% -lh5- a4b1 Apr 14 19:13 Amico8_v0.2/old/Amico8_v0.1/Amico8
[Amiga]                   1808    3476  52.0% -lh5- 127f Apr 14 17:55 Amico8_v0.2/old/Amico8_v0.1/Amico8.readme
[Amiga]                 184218  345496  53.3% -lh5- 6bb8 Apr 14 19:13 Amico8_v0.2/old/Amico8_v0.1/Amico8_040
[Amiga]                   1269    3161  40.1% -lh5- e8b6 Apr 14 19:23 Amico8_v0.2/old/Amico8_v0.1/games/amico8_demo_demo.p8
[Amiga]                   1223    3448  35.5% -lh5- fc2f Apr 14 19:20 Amico8_v0.2/old/Amico8_v0.1/games/amico8_demo_game.p8
[Amiga]                   2172    5645  38.5% -lh5- 98bc Apr 11 08:33 Amico8_v0.2/old/Amico8_v0.1/games/benchmark.p8
[Amiga]                   1538    3573  43.0% -lh5- afe0 Apr  6 17:23 Amico8_v0.2/old/Amico8_v0.1/games/testinput.p8
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        14 files  772345 1442378  53.5%            Apr 19 00:26