2015-09-04 00:07:34 -07:00
2015-09-04 00:07:34 -07:00
2015-04-22 18:19:50 -06:00
2015-04-25 18:41:03 -06:00
2015-04-22 18:19:50 -06:00
2015-09-03 15:26:19 -07:00

OCEmu - OpenComputers Emulator

Installation

Needs luafilesystem, utf8, and luaffi.

luasocket is optional but is required for the Internet Component and higher precision timing.

luasec is optional but is required for HTTPS.

luarocks-5.2 install luafilesystem
luarocks-5.2 install utf8
luarocks-5.2 install luasocket
luarocks-5.2 install luasec
git clone https://github.com/gamax92/luaffi.git
cd luaffi
make
sudo cp ffi.so /appropriate/path/for/lua/libraries/

# OpenComputer's lua source code is not provided, if you have svn then use the provided Makefile
# If you hate svn, manually download assets/loot, assets/lua, and assets/unifont.hex into src/

Mac users can get up and running quickly by using brew.

Brew installs luarocks as part of the lua package.

#run this before the luarocks install steps above
brew install lua
brew install sdl2

At this point, follow the luarock steps above. Then build luaffi as instructed. Then:

#at the time of this writing, the path is for version 5.2
sudo cp ffi.so /usr/local/lib/lua/5.2/

Windows users will have to manually compile everything, as luarocks seems to hate MSYS2/Cygwin

The provided script msys2_setup_ocemu.sh will automated the compiling process for Windows, run it in MSYS2

Native binaries will be provided when its ready.

Running

Launch boot.lua with lua5.2, and provided everything is installed, you'll have a working Emulator. OCEmu stores its files in $HOME/.ocemu or %APPDATA%\.ocemu, whichever happens to exist first.

cd src/
lua boot.lua

If you want to use a custom path (for example, for running multiple machines with unique filesystems) you can specify the machine path as an argument to boot.lua.

cd src/
lua boot.lua /path/to/my/emulated/machine_a
Description
OpenComputers Emulator in Lua
Readme 1.8 MiB
Languages
Lua 97.7%
Shell 2%
C 0.2%