SDLPAL 3DS: Difference between revisions

SDLPAL
SDLPAL
General
Author	SDLPAL Team
Type	Role Playing
Version	2.0
License	GPL-3.0
Last Updated	2021/02/14
Links
	SDLPAL & English Patch Download
	Website
	Source

Latest revision as of 06:34, 6 Mayıs 2024

SDLPAL is a SDL-based open-source cross-platform reimplementation of the classic Chinese RPG game The Legend of Sword and Fairy (Simplified Chinese: 仙剑奇侠传, Traditional Chinese: 仙劍奇俠傳, also known as Chinese Paladin, or PAL for short). It is availble in both Chinese and non-official English.

This port is created by Wei Mingzhi in 2009 and has been taken over by the SDLPAL development team. Many of the ideas of this program are based on documents from PAL Research Project, and portions of the code are based on the work done by Baldur and louyihua.

Note that this program does not include any code or data files of the original game, which are proprietary and copyrighted by SoftStar Inc.

Installation

Note: You must obtain the data files from a licensed copy of the game in order to run it.

Copy the CIA file to your SD card, then create a new folder named sdlpal in 3ds folder of your SD card.

Extract the game data files to the sdlpal folder (except for 2 folders and the AVI files, they are not needed).

Copy the sdlpal.cfg to the sdlpal folder just created (delete the .example at the end of the file name), so you should have sdmc:/3ds/sdlpal/sdlpal.cfg.

Open sdlpal.cfg, change CODEPAGE=0 to CODEPAGE=1 (delete the # in front of the line to enable it).

For n3ds/o3ds:

If you are using n3DS, turn on CPU+L2 boost in your CFW menu.
If you are using o3DS, open sdlpal.cfg, change both STEREO and USESURROUNDOPL to 0, lower both SAMPLERATE and OPLSAMPLERATE to 22050.

You can now install the CIA file and play the game in Chinese. To apply the English patch (included):

Extract everything except sdlpal.cfg in the win directory to the sdlpal directory of the SD card.
Overwrite m.msg, sss.mkf and word.dat, add m_chs.slf and m_eng.slf.
Open sdlpal.cfg and edit this line MESSAGEFILENAME=./m_eng.slf.

User guide

FAQ

Please see https://github.com/sdlpal/sdlpal/wiki/FAQ_CHS (Chinese).

Controls

D-Pad/C-Pad - Move, Select

A/Start - Enter

B/Select - Menu

L - Accelerate the game (not working on o3DS, up to maximum 3X of the speed so you can skip fight animation etc)

Screenshots

Media

SDLPAL 3DS Review (Chinese) (充满游戏)

Compatibility

Compatible with both o3DS and n3DS.

Tested on Citra.

Changelog

v2.0 2021/02/14

Experimental release for 2021-02-14.

v1.1 2017/02/18

Merged new functionality from mainline repository.

v1.0 2017/02/17

Initial release, based on a extremely outdated version of sdlpal. Fully playable with Pal DOS resource file:

Credits

This program made extensive use of the following libraries:

SDL
SDL_mixer
libmad
libogg & libvorbis
libopus & opusfile
FLTK
TinySoundFont
OPL player from Adplug
OPL emulation cores from DOSBOX project, MAME project and Chocolate Doom project
Audio resampler from foo_input_adplug
AVI player from ffmpeg
Image decoder from stb

External links

Official website - https://sdlpal.github.io/sdlpal
Author's website (zephray) - https://www.zephray.me/post/sdlpal_3ds_port
GitHub (SDLPAL team) - https://github.com/sdlpal/sdlpal
GitHub (zephray) - https://github.com/zephray/sdlpal-old
GitHub (weimzh) - https://github.com/weimzh/sdlpal
GBAtemp - https://gbatemp.net/threads/release-the-legend-of-sword-and-fairy-sdlpal-a-classical-dos-rpg-port-to-3ds.461422

@@ Line 1: / Line 1: @@
-{{Infobox 3DS homebrew
+{{Infobox 3DS Homebrews
-| title = SDLPAL
+|title=SDLPAL
-| image = https://dlhb.gamebrew.org/3dshomebrew/SDLPAL.jpg|250px
+|image=Sdlpal5.png
-| type = Other Apps
+|description=Port of The Legend of Sword and Fairy to the 3DS.
-| version = v2.0.2
+|author=SDLPAL Team
-| licence = Mixed
+|lastupdated=2021/02/14
-| author = ZephRay
+|type=Role Playing
-| website = https://github.com/nbzwt/sdlpal
+|version=2.0
-| download = https://dlhb.gamebrew.org/3dshomebrew/SDLPAL.rar
+|license=GPL-3.0
-| source = https://dlhb.gamebrew.org/3dshomebrew/SDLPAL.rar
+|download=https://dlhb.gamebrew.org/3dshomebrews/sdlpal.7z SDLPAL & English Patch
+|website=https://sdlpal.github.io/sdlpal
+|source=https://github.com/sdlpal/sdlpal
 }}
-<youtube>swZp8xbD2YI</youtube>
+SDLPAL is a SDL-based open-source cross-platform reimplementation of the classic Chinese RPG game The Legend of Sword and Fairy (Simplified Chinese: 仙剑奇侠传, Traditional Chinese: 仙劍奇俠傳, also known as Chinese Paladin, or PAL for short). It is availble in both Chinese and non-official English.
-=SDLPAL=
+This port is created by Wei Mingzhi in 2009 and has been taken over by the SDLPAL development team. Many of the ideas of this program are based on documents from [https://github.com/palxex/palresearch PAL Research Project], and portions of the code are based on the work done by Baldur and [https://github.com/louyihua louyihua].
-SDLPAL is an SDL-based reimplementation of the classic Chinese-language RPG "Xian Jian Qi Xia Zhuan" (also known as PAL or Legend of Sword and Fairy).
+Note that this program does not include any code or data files of the original game, which are proprietary and copyrighted by SoftStar Inc.
-===LICENSE===
+==Installation==
+'''Note:''' You must obtain the data files from a licensed copy of the game in order to run it.
-SDLPAL is originally created by Wei Mingzhi from 2009.
+Copy the CIA file to your SD card, then create a new folder named sdlpal in 3ds folder of your SD card.
-Copyright (c) 2009-2011 Wei Mingzhi <[email protected]>.
-Copyright (c) 2011-2016 SDLPAL development team.
-All rights reserved.
-SDLPAL is distributed under the terms of GNU General Public License, version 3
+Extract the game data files to the sdlpal folder (except for 2 folders and the AVI files, they are not needed).
-(or any later version) as published by the Free Software Foundation. See
-gpl.txt for details.
-Many of the ideas of this program are based on documents from PAL
+Copy the sdlpal.cfg to the sdlpal folder just created (delete the .example at the end of the file name), so you should have sdmc:/3ds/sdlpal/sdlpal.cfg.
-Research Project (https://github.com/palxex/palresearch), and portions of the
-code are based on the work done by Baldur and louyihua.
-The resampler code is based on the code in Kode54's foo_input_adplug project
+Open sdlpal.cfg, change CODEPAGE=0 to CODEPAGE=1 (delete the # in front of the line to enable it).
-(https://github.com/kode54/foo_input_adplug).
-This program made extensive use of the following libraries:
+For n3ds/o3ds:
+* If you are using n3DS, turn on CPU+L2 boost in your CFW menu.
+* If you are using o3DS, open sdlpal.cfg, change both STEREO and USESURROUNDOPL to 0, lower both SAMPLERATE and OPLSAMPLERATE to 22050.
-* SDL (http://www.libsdl.org/)
+You can now install the CIA file and play the game in Chinese. To apply the [http://www.romhacking.net/translations/2441 English patch] (included):
-* Adplug (http://adplug.sourceforge.net/)
+* Extract everything except sdlpal.cfg in the win directory to the sdlpal directory of the SD card.
-* SDL_mixer (http://www.libsdl.org/projects/SDL_mixer/)
+* Overwrite m.msg, sss.mkf and word.dat, add m_chs.slf and m_eng.slf.
-* libmad (http://www.underbit.com/products/mad/)
+* Open sdlpal.cfg and edit this line MESSAGEFILENAME=./m_eng.slf.
-* libogg & libvorbis (http://www.vorbis.com/)
-* FLTK (http://www.fltk.org)
-And some of the OPL simulation cores this program used are from the DOSBOX
+==User guide==
-project (http://www.dosbox.com) and MAME project (http://mamedev.org/).
+===FAQ===
+Please see https://github.com/sdlpal/sdlpal/wiki/FAQ_CHS (Chinese).
-Please see authors.txt for additional authors.
+==Controls==
+D-Pad/C-Pad - Move, Select
-This program does NOT include any code or data files of the original game,
+A/Start - Enter
-which is proprietary and copyrighted by SoftStar Inc.
-==COMPILE FOR NINTENDO 3DS==
+B/Select - Menu
-To compile, type:
+L - Accelerate the game (not working on o3DS, up to maximum 3X of the speed so you can skip fight animation etc)
-cd 3ds
+==Screenshots==
-make
+https://dlhb.gamebrew.org/3dshomebrews/sdlpal2.png
-make cia
+https://dlhb.gamebrew.org/3dshomebrews/sdlpal3.png
-You need to have DevkitPro ARM and SDL 1.2 for 3DS portlib installed. The
+https://dlhb.gamebrew.org/3dshomebrews/sdlpal4.png
-compiled executable should be generated with the filename 'sdlpal' at the
+https://dlhb.gamebrew.org/3dshomebrews/sdlpal6.png
-current directory.
-==CLASSIC BUILD==
+==Media==
+'''SDLPAL 3DS Review (Chinese)''' ([https://www.youtube.com/watch?v=swZp8xbD2YI 充满游戏]) <br>
-By default, SDLPAL uses a revised battle system which is more exciting yet
+<youtube>swZp8xbD2YI</youtube>
-somewhat harder than the original game. If you prefer the traditional
-turn-based battle system, uncomment the following line:
-//#define PAL_CLASSIC           1
-in the file common.h and recompile. This will build a "classic" build which is
+==Compatibility==
-% the same as the original game.
+Compatible with both o3DS and n3DS.
-==RUNNING THE GAME==
+Tested on Citra.
-The data files required for running the game are not included with the source
+==Changelog==
-package due to copyright issues. You must obtain them from the original CD.
+'''v2.0 2021/02/14'''
+* Experimental release for 2021-02-14.
-To run the game, copy all the files on the original CD to a directory, then
+'''v1.1 2017/02/18'''
-copy the SDLPAL executable to the same directory, and run the executable.
+* Merged new functionality from [https://github.com/nbzwt/sdlpal/releases/tag/v1.1 mainline repository].
-Note that the filenames of data files should be in lower-case under GNU/Linux
+'''v1.0 2017/02/17'''
-(or other UNIX-like operating systems).
+* Initial release, based on a extremely outdated version of sdlpal. Fully playable with Pal DOS resource file:
-==CONFIGURE THE GAME==
+==Credits==
+Copyright (c) 2009-2011, [https://github.com/CecilHarvey Wei Mingzhi].
-PAL has several variants using different and incompatible resource files. Now
+Copyright (c) 2011-2021, SDLPAL development team.
-SDLPAL supports several configuration options for supporting such variants.
-To set these configuration options, create a file named as 'sdlpal.cfg' (make
+This program made extensive use of the following libraries:
-sure to use lower-case file name in UNIX-like operating systems) in the game
+* [http://www.libsdl.org/ SDL]
-directory created by the above step. If no configuration file exists, SDLPAL
+* [http://www.libsdl.org/projects/SDL_mixer/ SDL_mixer]
-uses default values that supports the original resources of DOS version.
+* [http://www.underbit.com/products/mad/ libmad]
+* [http://www.vorbis.com/ libogg &amp; libvorbis]
+* [https://www.opus-codec.org/ libopus &amp; opusfile]
+* [http://www.fltk.org FLTK]
+* [https://github.com/schellingb/TinySoundFont TinySoundFont]
+* OPL player from [http://adplug.sourceforge.net/ Adplug]
+* OPL emulation cores from [http://www.dosbox.com DOSBOX project], [http://mamedev.org/ MAME project] and [https://github.com/chocolate-doom/chocolate-doom Chocolate Doom project]
+* Audio resampler from [https://www.foobar2000.org/components/view/foo_input_adplug foo_input_adplug]
+* AVI player from [https://ffmpeg.org/ ffmpeg]
+* Image decoder from [https://github.com/nothings/stb stb]
-Please refer to the 'sdlpal.cfg.example' for configuration file format.
+==External links==
+* Official website - https://sdlpal.github.io/sdlpal
+* Author's website (zephray) - https://www.zephray.me/post/sdlpal_3ds_port
+* GitHub (SDLPAL team) - https://github.com/sdlpal/sdlpal
+* GitHub (zephray) - https://github.com/zephray/sdlpal-old
+* GitHub (weimzh) - https://github.com/weimzh/sdlpal
+* GBAtemp - https://gbatemp.net/threads/release-the-legend-of-sword-and-fairy-sdlpal-a-classical-dos-rpg-port-to-3ds.461422