Dragon's Crown Pro - PC port (Linux)
Version @VERSION@

Dragon's Crown Pro for PlayStation 4, running natively on Linux x86-64: the
game's own code runs on the PC with a replacement for the PS4 system libraries
and a Vulkan renderer. This is a native build, not Wine or Proton. The same
AppImage runs on desktop Linux and on the Steam Deck.

Source code and issue tracker:
https://github.com/saulob/dragons-crown-pro-pc


THE GAME ITSELF IS NOT INCLUDED
-------------------------------
No game package or executable is included. You need your own legally obtained
copy of the game: a decrypted Dragon's Crown Pro PS4 package (.pkg). The port
does include the localization resources for its additional languages
(credited under PLAYING below). This port runs these releases:

  US:                 Title ID CUSA10454, versions 1.00 (the base package) and 1.01 (the base package, then the update)
  Japan:              Title ID CUSA07001, versions 1.00 (the base package), 1.02 and 1.03 (the base package, then the update)
  Asia, Hong Kong:    Title ID CUSA10209, versions 1.00 (the base package) and 1.02 (the base package, then the update)
  Europe:             Title ID CUSA10487, version 1.03 (one complete package, APP_VER 01.00, VERSION 01.03)

Any other version is refused with "Different version of Dragon's Crown Pro". The USA 1.01 update and the Japanese,
Asia, Hong Kong and European releases are not yet fully tested. The European build comes from one reporter's package
and has not been played yet; a copy dumped or re-wrapped differently is refused until it is reported.
A package still encrypted for a PS4 console cannot be unpacked on a PC.


REQUIREMENTS
------------
- 64-bit Linux (x86-64) with glibc 2.31 or later and a Vulkan loader for
  Vulkan 1.3 (libvulkan.so.1; Ubuntu 20.04's own is too old). The game has
  been run on Ubuntu 24.04 (WSL2) and, according to community reports, on
  Bazzite and a Steam Deck LCD; other distributions that are new enough may
  work
- A processor with AVX: Intel Core 2nd generation (Sandy Bridge), AMD FX or
  newer. The LZCNT, MOVBE and BMI1 instructions some of these lack are handled
  in software (without LZCNT, the USA 1.01 and Asia/Hong Kong 1.02 builds
  start only when the check of their LZCNT instructions at start passes)
- A graphics card and Mesa or proprietary driver with Vulkan 1.3,
  VK_EXT_robustness2, VK_KHR_push_descriptor and
  VK_EXT_vertex_attribute_divisor (AMD RADV on the Steam Deck qualifies)
- FUSE is optional. The AppImage normally mounts itself with FUSE; if that is
  not possible it unpacks itself into a temporary folder and runs from there
  automatically, with no special option. Setting APPIMAGE_EXTRACT_AND_RUN=1
  (or starting with --appimage-extract-and-run) forces that mode
- Your own Dragon's Crown Pro package, plus about 6 GB of free disk space next
  to the AppImage for the installed game
- Nothing else: no Python or other tools are needed; the AppImage carries its
  libraries (SDL3, FreeType, libpng, OpenSSL and others). GPU drivers and the
  Vulkan loader come from your system


INSTALL
-------
1. Put the AppImage in a folder you can write to (it keeps its game files,
   saves and logs beside itself) and make it executable:

     chmod +x DragonsCrownProPC-v@VERSION@-x86_64.AppImage

2. Run it (double-click, or from a terminal). The launcher opens.
3. On the Play page, click "Install game..." and select your .pkg file. The
   launcher uses the desktop's file chooser (zenity or kdialog) when there is
   one, and its own file chooser otherwise (mouse, keyboard or controller).
4. Wait while the launcher checks the package and unpacks it into the "game"
   folder next to the AppImage. The .pkg file is only read and can be deleted
   afterwards.
5. When the Play page says "Ready to play", press PLAY.

To repair the game files, use "Reinstall game..." on the Play page. Your
settings and saves are kept. If an installation fails or is cancelled, the
previous one is left as it was.


UPDATES
-------
The launcher checks the project's GitHub releases once per start. When a newer
AppImage exists, an update banner appears in the header; nothing is installed
until you choose UPDATE NOW and then RESTART TO UPDATE. The update replaces the
AppImage you started from and restarts it. Game files, user data, saves,
settings, logs and shader caches in the folders beside the AppImage are kept.


STEAM DECK
----------
Desktop Mode: copy the AppImage to a folder such as ~/Games/DragonsCrownPro,
make it executable (right-click > Properties > Permissions) and run it once to
install the game and set the options with the launcher.

Gaming Mode: in Desktop Mode open Steam, "Add a Game" > "Add a Non-Steam
Game...", then Browse and choose the AppImage (select "All Files" in the
chooser). The launcher opens first; its "Show this launcher" switch (Play
page) turns it off once everything is set.

This Linux build is EXPERIMENTAL: it is meant to offer everything the Windows
version does, but the maintainer has no real Linux PC or Steam Deck: it was
tested automatically under WSL2 (Ubuntu 24.04, X11 and Wayland, software
Vulkan) and by community testers. If something does not work, please attach the newest log from the "logs" folder
to an issue, with your distribution, GPU and driver.


PLAYING
-------
- F1 (or L3 + R3 on a controller) opens the Options menu.
- F11 switches between Windowed and Borderless Fullscreen.
- Controllers are read through SDL's gamepad support: Xbox controllers and the
  Steam Deck's own controls. The Windows build run through Proton (Bazzite Gaming
  Mode) turns SDL's HIDAPI drivers off by itself; an SDL_JOYSTICK_HIDAPI value you
  set is kept.
- The keyboard works too; the launcher's Controls page lists the keys.
- The Controls page also chooses the button prompts the game shows: PlayStation
  (original) or Xbox. It can be switched back at any time.
- Local multiplayer: up to four players, one controller each; the keyboard is always
  Player 1's. A controller connected later takes the lowest free player slot, and a
  player stays logged in when their controller is unplugged.
- Online Co-op: turn on Online Play on the launcher's Online page (Off by
  default) to meet friends and, if you choose, other players in the Lobby
  through a small online service; the
  game traffic goes directly between the players' PCs, or through the online
  service for a pair that cannot connect directly. Cheats are off while it
  is on. F3 shows the Ping during Online Play, F2 the frame counter.
  Online play on Linux and Steam Deck has not yet been tested on real hardware.
- The game itself unlocks online play only after the opening tutorial and story
  section. To get there faster, turn on Gameplay > Story Skip Offer and
  Tutorial Skip Offer before creating a new character.
- Discord Rich Presence shows your class, level, current place and party in
  your Discord status while the Discord desktop app runs. Discord shows it to
  whoever can see your status. To turn it off, add discord_presence = off to
  user/dcp.ini.
- Brazilian Portuguese covers game text, menus, subtitles, the launcher and the
  F1 options on every supported build. It is based on the work of
  Marcelo - Uma Ficha (https://www.youtube.com/@umaficha1), used with
  permission. New characters get Portuguese default messages; characters
  already in a save keep their own messages, and their unchanged default
  messages are shown in Portuguese. Credits and trophies stay in the build's
  own language. The translated manual pages are shown on the USA and
  European builds only.
- English on the Japanese and Asia/Hong Kong builds is provided by the PC
  port, not by the PS4 release. It is always listed, needs no other game or
  setup, and uses the same Menu & Subtitles selector as Portuguese (Brazil).
- Russian covers game text, menus, subtitles and character messages on every
  supported build. It is based on the fan translation by Exclusive Studio
  (https://ex-s.ru/dc.html), with PS4 porting work by AlchemistLab; it is not
  an official translation. No fan package is needed. The launcher, the F1
  options and the F10 overlay stay in English.
- F10 opens the Cheats menu (meant for offline and local play); the launcher has a
  Cheats page for the values saved for the next start. The cheats apply to
  every local human player; the Ally cheats apply to AI allies only.
- Character Editor (exclusive to this PC port): the launcher's Editor page
  finds your saves; pick a DATA slot and a character to recolor or hide
  individual parts of its appearance, or edit its name, level, skill points and
  HP. Nothing is written until Apply Changes, which backs up the save first.
  Players with a compatible version see your custom look online.
- Comms Wheel (Quick Chat): in an online room, D-pad Up (keyboard: T) opens eight quick
  messages (Ready, Hello, Need help, Let's go, Group up, Follow me, Good job,
  Thanks), shown in the game's own greeting balloon.
- Boss Battle: turn on Gameplay > Enable Boss Battle, then choose Boss Battle
  in the Inn menu to fight any of the 20 bosses, or all of them with Fight All.
  Your campaign save is protected during the fights.
- Gameplay > Unlock Labyrinth of Chaos and Unlock Ultimate + Tower of Mirages
  open that endgame content once the Stables are open; they are independent.
- Mouse: Left and Right Mouse attack; hold Middle Mouse (Pointer Control) to
  move the game's red hand pointer. Mouse Controls and Mouse Sensitivity are
  on the launcher's Controls page.
- An experimental AMD water workaround (black areas under characters standing
  in water) is on with AMD graphics cards and off elsewhere.
- To open the launcher again after turning it off, hold Shift while starting
  (X11 sessions), start the AppImage with the option --launcher, or use the
  "Show launcher" action of its desktop entry. On the Steam Deck: Steam > the
  game's Properties > Launch Options: --launcher; remove it again afterwards.


WHERE THINGS ARE
----------------
- Game files:     the "game" folder next to the AppImage file
- Logs:           the "logs" folder next to the AppImage file
- Settings (dcp.ini), saves, trophy progress, the Trophy Key (keep it
                  private) and shader cache:
                  the "user" folder next to the AppImage file

These folders are created when they are first needed and are not part of the
download. If the AppImage's folder is read-only, they are kept in
$XDG_DATA_HOME/DragonsCrownProPC (~/.local/share/DragonsCrownProPC) instead.
Setting DCP_PORTABLE_DIR to a folder chooses the place explicitly.

When updating the port, keep "user" (and "game", to skip reinstalling).

If the game does not start or crashes, please send a report from the launcher's
Bug Report page (Open preview shows exactly what goes out), or attach the newest
dragons_crown_pro_*.log file from the "logs" folder to a report at
https://github.com/saulob/dragons-crown-pro-pc/issues


LICENSE
-------
The original project code of this port is licensed under the GNU General
Public License v2.0 or later (GPL-2.0-or-later). The full text is in
usr/share/licenses/DragonsCrownProPC/LICENSE.txt inside the AppImage
(run it with --appimage-extract to see the files).

Third-party components keep their own licenses. Their license files and
notices are in the same folder, starting with THIRD-PARTY-LICENSES.txt.

The game package and executable are not included. The game and its assets are
not covered by this project's license.
This port is not affiliated with or endorsed by Vanillaware, Atlus, SEGA,
Sony Interactive Entertainment or any other rights holder of Dragon's Crown
Pro.
