Back to Squirrel Wiki

SqPlus compiles and runs on Win32, Linux, Mac OS-X, Sony PSP; should work with any modern C++ compiler. Unicode is supported. Can be downloaded, compiled and run in under 5 minutes (.zip includes all necessary files (build files for *nix and...

Source code (snapshot):

• "previous snapshots":
• "project page at sourceforge":
• Source code (stable): (Not working with gcc)

"SqPlus FAQ":

NEWS

See sqplus/changes.txt for lots more changes and the history of sqplus

• 07/13/08 - SQUIRREL2_1_1_sqplus_snapshot_20080713
• Converting encoding of strings in arguments by arst
• Changed SquirrelVM and SquirrelVMSys to make them hold a reference on a SQVM by arst
• Possibility to store a `sandbox VM by arst
• BindVariable of std::string by PallavNawani
• Fixed for typesafe scripting by Neimod
• Fixed memory leak in overloadConstructor by Kazei

Documentation

• See the examples in the testSqplus2unit directory for getting started with SqPlus
• Stepping through the examples with the debugger will provide insight into how the system works
• Forum questions are typically answered by adding a test case to testSqPlus2unit directory
• SqPlus is being used for a game in development. Updates are posted after changes during game development and/or to answer forum post questions
• Using the Wiki system is very easy: those wishing to add examples and/or documentation, feel free to make contributions |"Casino Online Slots"|

Features

• Easy to use: compiler does most of the work
• Simple design
• One header provides all template code
• One library for non-template code
• The template design will not cause the compiler to slow down or cause symbol bloat with debug builds
• Lightweight interfacing code: as fast as possible
• Relatively easy to understand and trace through
• Call system derived from "LuaPlusCD:":stable and tested design for many shipped PC and console games
• DXSquirrel MACRO type registration and utility classes and functions supported
• Relatively simple template usage: should work with any modern C/C++ compiler; VS.NET 2003 solutions and projects included
• Automatic type checking
• Automatic argument marshaling between script and C/C++
• boost::python/luabind/squadd style class registration: simple, concise syntax
• Function arguments
• Fixed
• Variable
• Class constructor arguments
• Fixed
• Variable
• Function return values
• Fixed
• Variable
• Multiple values of arbitratry type returned on stack
• Static support
• Class static variables and functions
• Any global variable or function can be registered in a class namespace
• Variables
• int, float, bool, string
• Fast+simple fixed length strings
• Can be registered as read-only in script
• New types can be created as classes and passed by value or address
• Easy to pass class instances between script and C++
• Constants
• int, float, bool, constant string types supported
• enums are registered as int
• All constants are read-only
• Class binding
• No proxy classes required
• Proxy/wrapper classes can be used if desired
• Automatic constructor/destructor creation
• Custom constructor/destructor support
• Static/global custom constructor/destructor can be used to prevent modification of original class
• Class inheritance
• Squirrel-style class inheritance supported
• C++ classes can inherit from Squirrel classes
• Squirrel classes can inherit from C++ classes
• Tables
• Simplified access and manipulation of Squirrel Tables
• Arrays
• Simplified access and manipulation of Squirrel Arrays
• Namespaces
• Can be created with tables, classes, or instances

Experimental

There is an experimental version of SqPlus available at that implements Squirrel virtual machines as proper objects. If you want to have more than one VM running, you simply construct more than one VM object. This modification is currently experimental. Comments in the forum are appreciated.

ExperimentalCode

SqPlusFeaturesToAdd

BugSubmissions

Script binding before SqPlus:

After SqPlus:

Note the tripling of productivity and improved disposition.