Skip to content

Zabqer/OCEmu

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OCEmu - OpenComputers Emulator

Installation

Needs lua-5.2, luafilesystem, luautf8, luaffi, and SDL2.
luasocket is optional but is required for the Internet Component and higher precision timing.
luasec is optional but is required for HTTPS.

Windows

Binaries: Windows 32bit and Windows 64bit (Build Date)

The binaries above have everything pre compiled and packed up for ease of use.

If you'd like to compile OCEmu yourself for Windows, the provided script msys2_setup_ocemu.sh will automated the compiling process for Windows, run it inside of the MSYS2 environment.
Ignore the Lua Libraries step as it doesn't work on Windows and the script does this for you.

Ubuntu

apt-get install lua5.2 liblua5.2-dev libsdl2-dev subversion

Install a versioned luarocks for 5.2 as described in: https://stackoverflow.com/a/20359102

# Download and unpack the latest luarocks from: https://luarocks.org/releases
./configure --lua-version=5.2 --lua-suffix=5.2 --versioned-rocks-dir
make build
sudo make install

Follow the luarocks steps below.

Arch Linux

Grab the Lua 5.2, luarocks5.2, lua52-filesystem, lua52-sec & lua52-socket from the official repos using Pacman.

pacman -S lua52 luarocks5.2 lua52-filesystem lua52-sec lua52-socket

Now follow the luarocks steps below to get the remaining libraries which are not on Arch's repos.

Mac

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 below
brew install lua
brew install sdl2

Follow the luarocks steps below.

Lua Libraries

luarocks-5.2 install luafilesystem
luarocks-5.2 install luautf8
luarocks-5.2 install luasocket
luarocks-5.2 install luasec
luarocks-5.2 install --server=https://luarocks.org/dev luaffi

# 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/font.hex into src/

Running

Launch boot.lua with lua5.2, and provided everything is installed, you'll have a working Emulator.
OCEmu stores its files in the following locations:

OS Location
Windows %APPDATA%\\OCEmu
Linux $XDG_CONFIG_HOME/ocemu or $HOME/.config/ocemu
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

About

OpenComputers Emulator in Lua

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Lua 97.9%
  • Shell 1.8%
  • Other 0.3%