Node.js bindings for raylib.
npm install raylibNode.js bindings for raylib, a simple and easy-to-use library to enjoy videogames programming (www.raylib.com).
| Name | Description | Author |
|:-----|:------------|:-------|
| Offical Examples | Ports of raylib's examples to node-raylib | @RobLoach, @twunky, @konsumer |
| Flappy | A Flappy Bird clone | @arthurmassanes |
| Retro RPG Template | Small prototype to build a retro-inspired RPG game | @konsumer |
| Chip8 | A CHIP-8 emulator whose native client using node-raylib | @taniarascia |
- Node.js >= 10
1. Create a new Node.js project:
`` bash`
mkdir myexample
cd myexample
2. Create a package.json file with:`
json`
{
"dependencies": {
"raylib": "*"
},
"scripts": {
"start": "node index.js"
}
}
3. Create a index.js JavaScript file, like core_basic_window.js:`
javascript
const r = require('raylib')
const screenWidth = 800
const screenHeight = 450
r.InitWindow(screenWidth, screenHeight, "raylib [core] example - basic window")
r.SetTargetFPS(60)
while (!r.WindowShouldClose()) {
r.BeginDrawing();
r.ClearBackground(r.RAYWHITE)
r.DrawText("Congrats! You created your first node-raylib window!", 120, 200, 20, r.LIGHTGRAY)
r.EndDrawing()
}
r.CloseWindow()
`
4. Have npm install the dependencies for you:
` bash`
npm install
5. Run index.js through Node.js:`
bash`
npm start
!Screenshot
Check for more examples organized by raylib modules.
Raylib is implemented as bindings with node-addon-api. Bindings are prebuilt for many platforms in Releases. If your platform is not supported by a prebuilt binary, you will need CMake to build the native addon. Windows users building manually will also require MSVC Build Tools 2019, or Visual Studio 2019 with build tools for C/C++.
In general, to install node-raylib locally, use npm:
``
npm install raylib
instead.
`js
import * as rl from 'raylib/drm/index.js'
const rl = require('raylib/drm')
`$3
node-raylib command-line tool to run node-raylib files directly:` bash
Unix
./bin/node-raylib core_basic_window.jsWindows
node bin/node-raylib core_basic_window.js
`The CLI can be installed globally through
npm or npx for no-install:` bash
npm install raylib --global
node-raylib --version
npx -y raylib --version
`Development
node-addon-api is used to construct the bindings. Raylib provides a header parser that generates a JSON file containing information on the API. The code binding raylib to NodeJS is automatically generated based on this file. For information on how bindings are written for raylib read the documentation. Code generators for the C++ bindings, TypeScript definitions, and JavaScript wrapper functions are found in the tools/generate_templates folder.
$3
Run the following to run tests...`
git clone https://github.com/RobLoach/node-raylib.git
cd node-raylib
npm i
npm t
`$3
Typescript definitions are provided by a generator based on raylib's header parser. See node-raylib-definitions.js for information on how to generate them.
$3
To build the packaged releases, use the following command:
`
npm run pkg
``node-raylib is licensed under an unmodified zlib/libpng license, which is an OSI-certified,
BSD-like license that allows static linking with closed source software. Check LICENSE for further details.
Copyright (c) 2022 Rob Loach (@RobLoach)