Subscribe to download
Momo's Encryption Library

The Wiki of this library[github.com]
Big update: compression is available!
The crash after a few hours is now fixed.

- Relative Lua paths are not allowed.
- Key: for clientside Lua includes, avoid crazy long keys.
- Using compression is important with the default "msubstract" method while encrypting Lua files and other text-based contents to ensure a reasonable encryption strength.
- This tool allows to encrypt Lua files, but it does not prevent Lua code capture tools from catching decrypted code. So code obfuscation is not useless.

Other encryption methods will be added later if possible.
free

momo_encryption.CreateKey( bits )

Generate a key of the given length.

return: (string) random hex string bits: (int) key length in bits

momo_encryption.Encrypt( key, content, compress, method )

Encrypts content with key.

return: (string) encrypted data key: (string) hex string content: (string) clear data compress: (bool) compress data using LZMA (recommended) method: (string) encryption method

momo_encryption.Decrypt( key, encrypted, paranoid, decompress, method )

Decrypts encrypted with key.

return: (string) decrypted data key: (string) hex string encrypted: (string) encrypted data paranoid: (bool) avoid using table.concat() decompress: (bool) decompress data using LZMA method: (string) decryption method

momo_encryption.EncryptFile( key, fileName, path, destination, compress, method )

Encrypts fileName as a binary file to destination with key.

return: (string) if destination == nil, the encrypted data key: (string) hex string fileName: (string) path to the clear file path: (string) File Search Path for fileName, see http://wiki.garrysmod.com/page/File_Search_Paths destination: (string) path to the destination file (relative to data folder) compress: (bool) compress data using LZMA (recommended) method: (string) encryption method

momo_encryption.DecryptFile( key, fileName, path, decompress, method )

Decrypts fileName as a binary file with key.

return: (string) decrypted data, false on failure key: (string) hex string fileName: (string) path to the encrypted file path: (string) File Search Path for fileName, see http://wiki.garrysmod.com/page/File_Search_Paths decompress: (bool) decompress data using LZMA method: (string) decryption method

momo_encryption.EncryptLuaFile( key, fileName, path, destination, compress, method )

Encrypts fileName as a Lua file to destination with key.

return: (no value) key: (string) hex string fileName: (string) path to the clear file path: (string) File Search Path for fileName, see http://wiki.garrysmod.com/page/File_Search_Paths destination: (string) path to the destination file (relative to data folder) compress: (bool) compress data using LZMA (recommended) method: (string) encryption method

momo_encryption.DecryptLua( key, encrypted, identifier, runNow, decompress, method )

Decrypts encrypted as Lua code with key.

return: (function) decrypted Lua code return: (vararg) if runNow, values returned by the Lua code key: (string) hex string encrypted: (string) encrypted Lua code identifier: (string) path to show in error messages (does not have to be unique) runNow: (string) run the Lua code now? decompress: (bool) decompress data using LZMA method: (string) decryption method

momo_encryption.DecryptLuaFile( key, fileName, identifier, runNow )

Decrypts fileName as a Lua file with key.

return: (function) decrypted Lua file return: (vararg) if runNow, values returned by the Lua file key: (string) hex string fileName: (string) full path to the encrypted Lua file (relative to lua folder) identifier: (string) path to show in error messages (does not have to be unique) runNow: (string) run the Lua file now?

momo_encryption.IncludeLuaFile( key, fileName, identifier, includeOnServer, includeOnClient )

Includes an encrypted Lua file on the server or on the client.

return: (vararg) if includeOnServer, values returned by the Lua file key: (string) hex string fileName: (string) full path to the encrypted Lua file (relative to lua folder) identifier: (string) path to show in error messages (does not have to be unique) includeOnServer: (bool) include the file serverside includeOnClient: (bool) include the file clientside

Note: Player:SendLua() is not used because of limited length & Lua code capturing danger.

free