Heroes3

     __  __                             ____________
    / / / /__  _________  ___  _____   /  _/  _/  _/
   / /_/ / _ / ___/ __ / _ / ___/   / / / / / /
  / __  /  __/ /  / /_/ /  __(__  )  _/ /_/ /_/ /
 /_/ /_/___/_/   ____/___/____/  /___/___/___/

          na AmigaOS 4.1 PPC (silnik VCMI)

  Wersja:  0.9.57 (beta)
  Port:    Rafal "Terror" Fajfrowski
  Kontakt: solargrim()gmail.com, eterror.pl


Heroes3
Heroes of Might and Magic III for the Amiga
A port of the VCMI engine to AmigaOS 3.x. It runs best on a PiStorm, but also
works on a 68040 or 68060 with a graphics card, or under WinUAE. Campaigns (The
Restoration of Erathia, Armageddon's Blade, The Shadow of Death), single
scenarios, hotseat, videos and online play.

The package contains only the engine. You need the game files from your own copy
of Heroes III, the easiest way is GOG.

Recommended: PiStorm (Raspberry Pi 3 or 4) with RTG, the game runs very fast on
it. On real CPUs a 68060 at 100 MHz or more is best. On a slower 68060 with an
RTG card the game works, but slowly, especially battles and enemy turns. On a
68040 it is even slower. On slower hardware turn the music off in vcmi-settings,
it speeds the game up noticeably.

Requirements
AmigaOS 3.x (68k)
PiStorm with RTG (recommended) or a 68040/68060 with an RTG card (Picasso96) and
an 800x600 mode in 16 or 32 bits. At least 160 MB of Fast RAM (with less the
game runs out of memory when a scenario starts). AHI for sound, any TCP/IP stack
for network play.

AmigaOS 4.1 PPC
AmigaOne X5000, X1000, A1222, Sam440, Sam460, Pegasos2 or an Amiga with a
Blizzard PPC or CyberStorm PPC card. AmigaOS 4.1 Final Edition, clib4.library
2.5 or newer, at least 256 MB of RAM. Does not run under WarpOS or PowerUP.

WarpOS (experimental version)
Blizzard PPC or CyberStorm PPC under AmigaOS 3.x, WarpOS (powerpc.library), an
RTG card (Picasso96) with an 800x600 mode in 16 or 32 bits, at least 160 MB of
Fast RAM, AHI for sound. If it does not work, use the 68k version on the
68040/68060 of the card.

AROS Raspberry Pi (experimental version)
Raspberry Pi 3 or 4, AROS raspi-aarch64 from the nightly build of 28.10.2026 or
newer, about 1.2 GB of space on the card. For now without online lobby play (TCP
and hotseat work) and without the Direct display mode.

AROS x86_64 (experimental version)
64-bit PC with AROS ABI v11 (AROS One 64-bit, AROS.games or AROS v11 2026.09
from axrt.org), about 1.2 GB of disk space. Does not run on the nightly AROS
pc-x86_64 builds (ABI v1). So far tested only in an emulator.


==[ Czego potrzeba ]=====================================================

  - AmigaOS 4.1 Final Edition (najlepiej z ostatnimi aktualizacjami)
  - clib4.library 2.5 lub nowsza w LIBS:
  - karta graficzna z trybem 800x600 w 16 albo 32 bitach
  - co najmniej 256 MB RAM (lepiej 512 MB)
  - pliki gry z wlasnego Heroes 3 (Data, Maps, Mp3), np. z GOG


==[ Instalacja ]=========================================================

  1. Zainstaluj clib4.library 2.5 lub nowsza (paczka clib4 z
     os4depot.net albo z github.com/AmigaLabs/clib4, zakladka
     Releases). Ze starsza wersja gra nie ruszy.

  2. Skopiuj cala paczke do katalogu z danymi gry (w podkatalogu,
     nie w glownym katalogu dysku):

    Heroes3/
      Data/  Maps/  Mp3/   pliki z Twojej gry
      config/  Mods/       z paczki
      scripts/             z paczki (bez tego nie dzialaja walki)
      userdata/            ustawienia, zapisy i logi
      vcmiclient_ppc       gra
      vcmi-settings        ustawienia, aktualizacja i start gry
      vcmi-update          instalator aktualizacji


==[ Uruchomienie ]=======================================================

  Dwuklik na vcmi-settings, ustaw co trzeba i "Zapisz i graj".

  Z Shella:
    cd Heroes3
    Stack 2000000
    vcmiclient_ppc >RAM:vcmi_out.txt


==[ vcmi-settings ]======================================================

  Obraz
    Tryb ekranu ..... Zmien wybiera tryb, wiekszy to wiecej mapy
    Pelny ekran ..... wylaczony = okno na Workbenchu
    Klatki/s ........ limit klatek
    Kursor .......... programowy ma ksztalty z gry (np. kierunek ataku)
    Czcionki ........ oryginalne sa najszybsze

  Gra
    Jezyk ........... jezyk napisow VCMI (teksty z gry sa w jezyku
                      Twoich danych)
    Joystick/pad .... wlacz, jesli grasz padem

  Dzwiek
    Muzyka, Efekty .. wlaczasz osobno kratka przy suwaku glosnosci

  Siec
    Nick ............ Twoja nazwa w lobby, 4 do 20 liter i cyfr
    Serwer, porty ... zostaw domyslne

  Aktualizacja ...... pobiera i instaluje nowa wersje dla OS4
  Wyslij log ........ wysyla log z ostatniej gry do autora


==[ Gdy cos sie wysypie ]================================================

  Napisz na solargrim()gmail.com i dolacz:
  - wersje systemu i sprzet (X5000, X1000, A1222, Sam460, Classic PPC)
  - RAM:vcmi_out.txt i userdata/VCMI_Client_log.txt
    (albo uzyj "Wyslij log" w vcmi-settings)
  - przy oknie Grim Reapera: zdjecie lub zrzut, najlepiej tez
    zakladke ze stosem (Stack trace)