DontStarveLuaJIT

Don't Starve LuaJIT/OpenGL ES optimization patch (compatible with DS, RoG, SW, HAM, DST, Dedicated Server for Windows and DST, Dedicated Server for Linux)

This MOD is to replace the builtin script engine with LuaJIT to accelerate you game! PLEASE BACKUP YOUR SAVES BEFORE APPLYING THIS PATCH.

这个补丁可以将饥荒游戏内的脚本引擎替换为LuaJIT以提升性能。在启用这个补丁之前，请务必备份你的所有存档。

Original Game 原版游戏 (FPS: 48-50)

lua

Game with LuaJIT 启用LuaJIT之后(FPS: 57-58)

luajit

All technique detils available at: https://zhuanlan.zhihu.com/p/24570361 (Chinese only).

我把本文所有技术细节、原理发在了知乎专栏上，如果对项目有疑问可以先看看文章。

Installation（安装）:

NOTICE: LuaJIT has two modes, the jit mode and non-jit mode.
By default, the non-jit mode is enabled, but it is not always the best choise for your PC.
Please try to switch between jit and non-jit mode after installation:
Press backspace, then launch console by Ctrl + `, and type the following then press ENTER:
jit.off() -- for disabling jit mode (default)
jit.on() -- for enabling jit mode
Select the one with higher FPS.
NOTICE: The non-jit mode of LuaJIT is not equivalent to buildin one, the former is much more faster.
特别注意：LuaJIT有两种模式，jit模式与非jit模式，默认启用jit模式。
由于饥荒及其MOD代码的特殊性，LuaJIT插件的jit模式并不能保证在所有情况下都比非jit模式提升性能，
请在安装插件后，按退格键显示帧率，然后在控制台切换jit模式：
关闭jit模式（默认）：jit.off()
开启jit模式：jit.on()
选择拥有较高帧率的即可
注意LuaJIT插件的非jit模式并不等同于原版Lua，前者的速度本身就比原版Lua要快很多。

Windows



Copy all files from folder "win" to "[Your Don't Starve [Together] Directory]/bin/"
复制发布包"win"目录下的所有文件至"[您的Don't Starve [Together] 安装目录]/bin/"
	
Launch the game, press ` and type:
启动游戏，按`打开控制台，输入：
	
print(_VERSION)
	
And you can see message started with "LuaJIT".
你可以看到LuaJIT字样的输出，这就说明已经安装成功。

If you want uninstall this patch, just remove these copied files (i.e. WINMM.DLL, lua51.dll, lua51DS.dll) from the bin folder.
如果需要卸载本Patch，只需要删掉您这些新复制的文件（WINMM.DLL, lua51.DLL, lua51DS.dll）即可。

Linux


It's highly recommended to compile the release yourself. See the section 'Compilation' below.
强烈建议自行编译linux版本，具体操作方式请看下文“编译”一节。

Copy all files from folder "linux" to "[Your Don't Starve [Together] Directory]/bin/lib32/", start game with the following environment setting:
复制发布包"linux"目录下的所有文件至"[您的Don't Starve [Together] 安装目录]/bin/lib32"，使用如下环境参数启动游戏：
	
export LD_PRELOAD=libpreload.so

NOTICE: libpreload.so/liblua51.so/liblua51DS.so may rely on some C-runtime libraries, which are not present on your computer.
Try to use ldd to find dependencies and install them.
注意，由于Linux平台的特殊性，发行包中提供的libpreload.so、liblua51.so、liblua51DS.so可能无法直接在您的计算机上执行。
如果您遇到安装失败，则一般是由于liblua51DS.so的依赖没有安装导致的。您可以使用ldd命令来查看缺少哪些依赖并安装它们，比如：

ldd liblua51DS.so
	
For example, if 'readline' was reported missing, then you could have it installed by following instructions(Debian/Ubuntu):
比如提示readline找不到，那么就使用如下命令安装(Debian/Ubuntu)：
	
sudo apt-get install lib32readline6
	
If your system are suggrested to install newer version of lib32realine, e.g. lib32readline8. Making a soft link of it to could work.
如果您的系统比较新（如Debian buster），可能只能安装高版本的lib32readline8，您可以制作一个软链接到lib32readline6来使用。

For dedicated server, that's enough. But it's not work with the game client, since the game requests steam to restart it if it was not started by steam.
As a result, LD_PRELOAD will be missing when steam starts it. Here's a workaround from hyiltiz that works:
对于独立服务器而言，上面的步骤做完后就可以启动服务器了。但是客户端并不行，这是因为客户端会请求steam去启动它。
这样二次启动后LD_PRELOAD参数就无效了，您可以通过以下的方案绕过它：

Rename dontstarve to dontstarve.bin:
将dontstarve程序重命名为dontstarve.bin:

mv dontstarve dontstarve.bin

Write a new bash with following content:
编写一个新的脚本，内容如下，命名为dontstarve：
	
#!/bin/sh
LD_PRELOAD=libpreload.so ./dontstarve_steam.bin

Add executable access:
加入执行权限：

chmod +x dontstarve_steam

Then enjoy your game!
接着就可以运行游戏了！

Compilation（编译）:

The following part is for developers only.

**普通玩家止步。这部分内容是给开发者看的。**

Windows

For Windows version, the project 'lua51' in solution must be compiled with MSVC9 (Visual Studio 2008) to generate 
binary-compatible code for dontstarve_steam.exe. To compile luajit, please launch Visual C++ 
Build Prompt and run msvcbuild.bat.

对于Windows版本，为确保与饥荒主程序的二进制兼容性，解决方案中的lua51必须使用MSVC9（即VS2008）来编译。

如果您要自行编译luajit，请在Visual C++的控制台中运行luajit目录下的msvcbuild.bat。

Linux

For linux version, the project 'lua51' must be compiled with GCC 4.8.4:i386, which is builtin compiler tool of Ubuntu 14.04 LTS.

对于Linux版本，lua51工程需要使用GCC 4.8.4:i386编译。您可以安装Ubuntu 14.04 LTS版本，使用自带的GCC即可。

Acknowledgements（致谢）:

Great thanks to the following players for testing and suggestions!

感谢以下网友对于MOD的测试和建议！

	风雨凌芸、子恒Clark、359368170、lild100、kkrbdsgc、__PeakChen、o裙下臣o、 LC_1992、
	pikry、沉睡森丶林、可待year、绝世鱼人、王太太平、力玄破、渊_雎、风雪归途、幻想草莓梦、
	sharpwind95、乔碧萝、辣椒小皇纸、☆风铃草☆、hyiltiz