Return To The Roots

返璞归真(Settlers II(R) 克隆版)。「Return To The Roots (Settlers II(R) Clone)」

Github星跟踪图

Return To The Roots

"Return To The Roots" is a fan-project, which aims to renew the original The Settlers 2.

We aim to extend new features such as a multiplayer mode via internet as well as the support for modern hardware and several operating systems like Windows XP/Vista/Seven, Linux and MacOS X. Likewise we want to invent some smaller upgrades. Unfortunately it is necessary to rewrite the whole game, but we will stick to the original graphics and sounds, because they are still common and nice to be heard or seen.
So you will still need an original "The Settlers 2 Gold Edition" version to play Return To The Roots.

see more information on http://www.rttr.info

Current Build Info

Travis CI: Travis CI Build Info

Appveyor: Appveyor CI Build Info

Coverage:
Coverage Status
/
codecov

How to install

  • Download the game for your OS at Downloads
    • stable: Usually more stable
    • nightly: Latest features and bug fixes, but might be broken sometimes
  • Extract into a folder of your choice
  • Locate the file put your S2-Installation in here in that folder (usually at the root or in S2)
  • Copy the DATA and GFX folder from the original The Settlers II Gold into the folder containing the above file
  • Start rttr.bat/rttr.sh or the bundle (OSX only) to auto-update and start the game
    • Alternatively start s25client directly, but updates and music might be missing
  • WARNING: Do not use symlinks/junction points/... for subfolders of your installation. Putting RttR in a symlinked folder should work though.

How to build

On Linux or Darwin/MacOSX

Prerequisite Linux:

  • C++14 compatible compiler (e.g. GCC-6)
  • cmake
  • git
  • libboost-dev (at least v1.64.0, i.e http://www.boost.org/)
  • libboost-locale-dev, libboost-iostreams-dev, libboost-filesystem-dev, libbost-program-options-dev (at least v1.64.0)
  • libsdl1.2-dev
  • libsdl-mixer1.2-dev
  • libsdl2-dev (optional)
  • libsdl2-mixer-dev (optional)
  • licurl-dev (in libcurl4-openssl-dev)
  • libbz2-dev
  • lua5.2-dev
  • gettext
  • libminiupnpc-dev

All of them can be installed with the package manager.

Prerequisite MacOSX:

  • cmake
  • git
  • boost
  • sdl(2)
  • sdl_mixer
  • gettext (make sure it is in your path with e.g. brew link --force gettext)
  • miniupnpc

All of them can be installed via homebrew

Prerequesites with Nix

Nix users can open a nix-shell to get a development environment with all packages ready.

Steps:

git clone --recursive https://github.com/Return-To-The-Roots/s25client s25client
cd s25client
nix-shell # Optional, for Nix users only
mkdir -p build && cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make

Note: by using the -G option of cmake you can specify a generator, e.g. cmake -G Xcode -DCMAKE_BUILD_TYPE=Release .. will generate an Xcode project.
Please check cmake --help for more options.

Optimizations:

There are various CMake options to control the build and optimization including ARM (Rasberry PI etc.) related ones. Examples:

  • RTTR_ENABLE_OPTIMIZATIONS/RTTR_ENABLE_WERROR
  • RTTR_OPTIMIZATION_VECTOR_EXT (Non-Windows x86/x64 only)
  • RTTR_OPTIMIZATION_TUNE (Non-Windows only)
  • RTTR_TARGET_BOARD (ARM only)
    See the description in CMake-GUI/ccmake for details.

Note that due to the use of submodules you always need to git pull && git submodule update --init --recursive to get the latest version.
(The --init and --recursive arguments are only required should we add new submodules to the existing set.)

On Windows

Prerequisites:

Steps:

  • Clone GIT Repository from https://github.com/Return-To-The-Roots/s25client
    • Using Git bash:

      git clone --recursive https://github.com/Return-To-The-Roots/s25client s25client
      
    • OR using TortoiseGit:

      • Rightclick -> "Git clone..."
      • Put in https://github.com/Return-To-The-Roots/s25client as URL
      • Select "Directory" to clone to
      • press OK
      • Rightclick on the newly created folder -> TortoiseGit-> Submodule Update
      • Make sure all modules are selected and "Initialize submodules (--init)" is checked
      • press OK
  • Extract external/full-contrib-msvc.rar to external
    (so that external/full-contrib-msvc/bin, external/full-contrib-msvc/include and external/full-contrib-msvc/lib exist)
  • If you havent installed boost, install boost
    Fast Way:
    • extract boost-1.64.zip (i.e to external/boost, so that external/boost/bootstrap.bat exist)
    • run that "bootstrap.bat"
    • run created "b2.exe": this should build boost
      Notice: if you have multiple Visual Studio versions installed, use the latest one with the "toolset"-parameter.
      i.e "b2 toolset=msvc-14.0" for Visual Studio 2015
    • run "b2 install --prefix=%CD%": this should install everything so the system can find it
      Notice: Don't forget to add the toolset parameter if you already used it before
  • Use cmake-gui:
    • "Where is the source code": Select checked out directory
    • "Where to build the binaries": Select "build" directory (create if required)
    • Press configure
    • Select your compiler version (i.e Visual Studio 2015 x64)
    • If it can't find boost:
      • "Add Entry"
      • Enter as "Name" "BOOST_ROOT" (exact casing!)
      • Select for "Type" "PATH"
      • Enter boost installation path for "Value"
      • Press ok
    • Press generate
  • Open and use build/s25client.sln

--

for advanced info or help see FAQ in the wiki or http://www.rttr.info

主要指标

概览
名称与所有者Return-To-The-Roots/s25client
主编程语言C++
编程语言CMake (语言数: 10)
平台
许可证GNU General Public License v2.0
所有者活动
创建于2013-07-07 09:38:04
推送于2025-06-03 08:39:29
最后一次提交2025-06-03 10:39:28
发布数15
最新版本名称v0.9.5 (发布于 )
第一版名称0.7.2 (发布于 )
用户参与
星数512
关注者数29
派生数83
提交数5.9k
已启用问题?
问题数1136
打开的问题数260
拉请求数573
打开的拉请求数17
关闭的拉请求数50
项目设置
已启用Wiki?
已存档?
是复刻?
已锁定?
是镜像?
是私有?