|Wei Mingzhi 42b6b53958 keyrepeat in SDL2 is non-customizable, so use PAL_GetKeyboardState() instead||2 years ago|
|3ds||2 years ago|
|3rd||2 years ago|
|adplug||2 years ago|
|android||2 years ago|
|emscripten||2 years ago|
|incomplete_ports||2 years ago|
|ios||2 years ago|
|libmad||2 years ago|
|liboggvorbis||2 years ago|
|macos||2 years ago|
|native_midi||2 years ago|
|scripts||2 years ago|
|tests||2 years ago|
|unix||2 years ago|
|win32||2 years ago|
|winrt||2 years ago|
|.appveyor.yml||2 years ago|
|.gitignore||2 years ago|
|.gitmodules||2 years ago|
|.travis.yml||2 years ago|
|AUTHORS.txt||4 years ago|
|README.md||2 years ago|
|_config.yml||2 years ago|
|ascii.h||2 years ago|
|audio.c||2 years ago|
|audio.h||2 years ago|
|aviplay.c||2 years ago|
|aviplay.h||2 years ago|
|battle.c||2 years ago|
|battle.h||2 years ago|
|codepage.h||2 years ago|
|common.h||2 years ago|
|ending.c||2 years ago|
|ending.h||2 years ago|
|fight.c||2 years ago|
|fight.h||2 years ago|
|font.c||2 years ago|
|font.h||2 years ago|
|fontglyph.h||2 years ago|
|game.c||2 years ago|
|game.h||2 years ago|
|global.c||2 years ago|
|global.h||2 years ago|
|gpl.txt||7 years ago|
|input.c||2 years ago|
|input.h||2 years ago|
|itemmenu.c||2 years ago|
|itemmenu.h||2 years ago|
|magicmenu.c||2 years ago|
|magicmenu.h||2 years ago|
|main.c||2 years ago|
|main.h||2 years ago|
|map.c||2 years ago|
|map.h||2 years ago|
|midi.c||2 years ago|
|midi.h||2 years ago|
|mp3play.c||2 years ago|
|oggplay.c||2 years ago|
|overlay.c||2 years ago|
|palcfg.c||2 years ago|
|palcfg.h||2 years ago|
|palcommon.c||2 years ago|
|palcommon.h||2 years ago|
|palette.c||2 years ago|
|palette.h||2 years ago|
|play.c||2 years ago|
|play.h||2 years ago|
|players.h||2 years ago|
|private.c||5 years ago|
|res.c||2 years ago|
|res.h||2 years ago|
|resampler.c||2 years ago|
|resampler.h||4 years ago|
|riff.h||2 years ago|
|rixplay.cpp||2 years ago|
|rngplay.c||2 years ago|
|rngplay.h||2 years ago|
|scene.c||2 years ago|
|scene.h||2 years ago|
|script.c||2 years ago|
|script.h||2 years ago|
|sdlpal.cfg.example||2 years ago|
|sdlpal.ico||4 years ago|
|sdlpal.xpm||7 years ago|
|sound.c||2 years ago|
|text.c||2 years ago|
|text.h||2 years ago|
|ui.c||2 years ago|
|ui.h||2 years ago|
|uibattle.c||2 years ago|
|uibattle.h||2 years ago|
|uigame.c||2 years ago|
|uigame.h||2 years ago|
|util.c||2 years ago|
|util.h||2 years ago|
|video.c||2 years ago|
|video.h||2 years ago|
|yj1.c||2 years ago|
SDLPAL is an SDL-based open-source cross-platform reimplementation of the classic Chinese RPG game Xiān jiàn Qí Xiá Zhuàn (Chinese: 仙剑奇侠传/仙劍奇俠傳) (also known as Chinese Paladin or Legend of Sword and Fairy, or PAL for short).
SDLPAL is originally created by Wei Mingzhi from 2009.
Copyright (c) 2009-2011, Wei Mingzhi <firstname.lastname@example.org>. Copyright (c) 2011-2017, SDLPAL development team. All rights reserved.
SDLPAL is distributed under the terms of GNU General Public License, version 3 (or any later version) as published by the Free Software Foundation. See gpl.txt for details.
This program made extensive use of the following libraries:
Please see AUTHORS.txt for additional authors.
This program does NOT include any code or data files of the original game, which are proprietary and copyrighted by SoftStar Inc.
Want to chat with other members of the SDLPal community?
We have a Gitter Room which you can join below.
Currently, SDLPAL supports the following platforms:
To build SDLPAL, there are three major steps you need to do:
gitor through corresponding GUI:
shell $ cd <parent-path-of-sdlpal> $ git clone https://github.com/sdlpal/sdlpal.git
git submoduleor through corresponding GUI:
shell $ cd <parent-path-of-sdlpal>/sdlpal $ git submodule update --init --recursive
To build SDLPAL as a Windows desktop app, you can use Microsoft Visual Studio 2015 or Microsoft Visual Studio 2017 to open the solution file
sdlpal.sln under the
To build SDLPAL as a Universal Windows Platform app, you can use Microsoft Visual Studio 2015 or Microsoft Visual Studio 2017 to open the solution file
SDLPal.UWP.sln under the
There are also solution files for building traditional Windows (phone) store app under the
winrt directory, but they are deprecated (which means there will be no further platform-specific feature update for these two platforms) and may be removed in future.
To build SDLPAL as a Windows desktop app, you can also use MinGW. Steps for building under MinGW varies depends on the compiling environment you have:
If you need to compile SDLPAL under Windows shell environment, please go to the root of the source code tree and type:
C:\sdlpal> cd win32 C:\sdlpal> make -f Makefile.mingw
If you need to compile SDLPAL under msys shell environment, please go to the root of the source code tree and type:
$ cd win32 $ make
If you need to cross-compile SDLPAL under Linux shell environment, please go to the root of the source code tree and type:
$ cd win32 $ # This builds a 32-bit executable. $ make HOST=i686-w64-mingw32- $ # This builds a 64-bit executable. $ make HOST=x86_64-w64-mingw32-
To build the game, please go to the root of the source code tree and type:
$ cd unix $ make
You also need to have SDL 2.0 development files installed in the system. The compiled executable should be generated with the filename
sdlpal at the current directory. By default, SDLPAL uses the FLTK library to provide setting GUI at launch. If you do not want to use the library, please define he macro
PAL_NO_LAUNCH_UI in the
Makefile. SDLPAL should also be able to compile and run under other Unix-like systems, however it's not tested.
To compile, open
Xcode, and click Build. You need to have SDL framework installed at
To compile, please first install dependencies via CocoaPods following the above instruments, then open the project
Xcode, and click Build.
$ cd iOS/SDLPAL $ sudo gem install cocoapods # ONLY need do once on one machine $ pod install # ONLY need do once in one repository
To build the game, open the
android directory through Android Studio, and click
To build the game, please go to the root of the source code tree and type:
cd 3ds make make cia
You need to have DevkitPro ARM and SDL 1.2 for 3DS portlib installed. The compiled executable should be generated with the filename
sdlpal at the current directory.
To be written.
By default, SDLPAL builds a "classic" turn-based battle system which is designed to be 100% the same as the original game.
SDLPAL also provides a revised battle system (deprecated and will be removed in future) which is more exciting yet somewhat harder than the original game. If you prefer this battle system, please define the macro
Makefile or in
common.h and recompile the project.
The data files required for running the game are not included with the source package due to copyright issues, so you need to obtain them from a licensed game copy before you can run the game.
To run the game, copy all the files in the original game CD to a directory, then copy the built SDLPAL executable to the same directory, and run the executable.
Note that the filenames of data files should be all in lower-case under systems that use case-sensitive filesystems such as Linux or other Unix-like operating systems.
If you prefer using MIDI as background music source, please note that the MIDI playing feature is not yet complete under every supported platform. Currently, offical support is provided under Windows Desktop, Universal Windows Platform, Android, iOS and macOS. There is also a preliminary support for Linux that relys upon package timidity. Other platforms do not support playing MIDI for now.
PAL has several variants using different and incompatible resource files, and SDLPAL supports several configuration options for supporting such variants. The default values are used to support the resources from original DOS version. If you want to change these configurations, you have two options: through the configuration GUI or by manipulating the configuration file
The configuration GUI provides options for you to change the most common configuration options. If you launch SDLPAL for the first time, it will bring you to the configuration GUI by default. Once you have saved configurations from the GUI, the GUI will not to show again on subsequent launches. However, you have the opportunity to bring the GUI back on fatal game program errors or through the in-game system menu.
Currently, the configuration GUI is available under the following platforms:
Configuration GUIs for macOS is still unavailable for now and we welcome contributions to implement it.
To set the configuration options manually, create a file named as
sdlpal.cfg (make sure to use lower-case file name in case-sensitive filesystems) in the game directory created by the above step. Please refer to the file sdlpal.cfg.example for format specfication.
If you find any issues of SDLPAL, please feel free to report them to the development team through Github's issue tracking system using either English or Chinese.
Any original code & documentation contributions are welcomed as long as the contributed code & documentation is licensed under GPL. You can use Github's pull request system to submit your changes to the main repository here. But remember, as a step to keep the quality of code, you should write corresponding unit tests before your changes can be merged. The guidance of writting unit tests can be found here.