Dragon's Crown Pro - PC port
Version @VERSION@

Dragon's Crown Pro for PlayStation 4, running natively on Windows: the game's
own code runs on the PC with a replacement for the PS4 system libraries and a
Vulkan renderer.

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
------------
- Windows 10 version 1903 or later, or Windows 11, 64-bit
- 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 driver with Vulkan 1.3, VK_EXT_robustness2,
  VK_KHR_push_descriptor and VK_EXT_vertex_attribute_divisor
- Your own Dragon's Crown Pro package, plus about 6 GB of free disk space next
  to the program for the installed game
- Nothing else: no Python or other tools are needed


INSTALL
-------
1. Extract the ZIP anywhere you can write to (not "Program Files").
2. Run dragons_crown_pro.exe. The launcher opens.
3. On the Play page, click "Install game...".
4. Select your Dragon's Crown Pro .pkg file.
5. Wait while the launcher checks the package and unpacks it into the "game"
   folder next to the program. The .pkg file is only read and can be deleted
   afterwards.
6. 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
release exists, an update banner appears in the header; nothing is installed
until you choose UPDATE NOW and then RESTART TO UPDATE. The update replaces
only the port's own program files. Game files, user data, saves, settings,
logs, shader caches and DLC are kept.


WINDOWS SMARTSCREEN
-------------------
The first time you run dragons_crown_pro.exe, Windows SmartScreen may show a warning,
because the program is not digitally signed. If you downloaded the release
from the project's GitHub releases page, choose "More info", then
"Run anyway".


PLAYING
-------
- F1 (or L3 + R3 on a controller) opens the Options menu.
- F11 switches between Windowed and Borderless Fullscreen.
- Xbox controllers work without setup.
- 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.
- 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.
- If the game closes right after PLAY while a recording, chat or performance
  overlay program is running, turn on Gameplay > Allow overlay programs in the
  launcher.
- To open the launcher again after turning it off, hold Shift while starting.


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

These folders are created when they are first needed and are not part of the
download. When updating the port, keep "user" (and "game", to skip
reinstalling). Versions before 0.7.0 were started with dcp-loader.exe;
delete that file and use dragons_crown_pro.exe instead.

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
LICENSE.txt.

Third-party components keep their own licenses. Their license files and
notices are in the "licenses" 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.
