PHPackages                             eurobertics/nebucord - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. eurobertics/nebucord

AbandonedArchivedLibrary[API Development](/categories/api)

eurobertics/nebucord
====================

A full featured Discord WebSocket and REST API.

v1.2.2(1y ago)81704GPL-3.0-or-laterPHPPHP ^8.1

Since Aug 12Pushed 1mo ago3 watchersCompare

[ Source](https://github.com/Eurobertics/Nebucord)[ Packagist](https://packagist.org/packages/eurobertics/nebucord)[ RSS](/packages/eurobertics-nebucord/feed)WikiDiscussions master Synced today

READMEChangelog (10)Dependencies (1)Versions (29)Used By (0)

#### Important notice | March 25, 2026

[](#important-notice--march-25-2026)

Hello,

unfortunately I have some bad news.
I will sunset this project due to new projects. I'm also a bit discontent since a while about the way Discord is getting along currently. So this project remains here but in an archived state and is as of now discontinued. I will not further develop this project nor do fixes. There are a lot of other great Discord API frameworks out there. Maybe not in PHP but in other very good languages and flavors. Also the container images will still available but unmaintained (this includes both used registries GHCR and Docker Hub).

Thank you for your support not only on Github.
Eurobertics

---

Nebucord - Discord WebSocket and REST API
=========================================

[](#nebucord---discord-websocket-and-rest-api)

[![GitHub Release](https://camo.githubusercontent.com/2ce15c4e739e125ad01a0490ff4add5a7f0b0c989def0c46622ca0b2048d74a0/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f6575726f626572746963732f6e656275636f72642e7376673f636f6c6f72423d627269676874677265656e266c6162656c3d6c61746573742d737461626c65)](https://github.com/eurobertics/nebucord)[![GitHub Development](https://camo.githubusercontent.com/e21642fd40790b12fd4065aee0d8c8435c3371ae14706b445883af0ec470ff2f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6465762d2d6d61737465722d76312e322e322d7265642e737667)](https://github.com/eurobertics/nebucord)[![GitHub license](https://camo.githubusercontent.com/d06a67a55a7de2121dc7ac92237d4bc19baadf63941ef59bca62a7bafaebe62f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6575726f626572746963732f6e656275636f72642e737667)](https://github.com/Eurobertics/Nebucord/blob/master/LICENSE)[![Security Rating](https://camo.githubusercontent.com/c58c7f5fef6115419ee20799642921c39edc7a72e6a43d5650836d48d1c2c453/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d4575726f626572746963735f4e656275636f7264266d65747269633d73656375726974795f726174696e67)](https://sonarcloud.io/summary/new_code?id=Eurobertics_Nebucord)[![Quality Gate Status](https://camo.githubusercontent.com/b85aa77548e3abd4bde89eb4855a7b5cba8cdf564ca49da20b04c603cc973b61/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d4575726f626572746963735f4e656275636f7264266d65747269633d616c6572745f737461747573)](https://sonarcloud.io/summary/new_code?id=Eurobertics_Nebucord)

[![SonarCloud](https://camo.githubusercontent.com/6c4c5f2b880ecf74ee24fb0d5b4f98e3aa482239167d2834cba1a40e2e60d74c/68747470733a2f2f736f6e6172636c6f75642e696f2f696d616765732f70726f6a6563745f6261646765732f736f6e6172636c6f75642d77686974652e737667)](https://sonarcloud.io/summary/new_code?id=Eurobertics_Nebucord)

This is another implementation of the Discord API. It implements an HTTP WebSocket client as well as a REST API.
An actual in use sample can be found on our Discord server: [Nebulatien](https://discord.gg/fVHmDD3) [![Discord](https://camo.githubusercontent.com/95b30f963245ccd8d40cf96dc6dd3c4a01f5c658349e08d1e5c7d22519e45eae/68747470733a2f2f696d672e736869656c64732e696f2f646973636f72642f343239323034303235363738373537383939)](https://camo.githubusercontent.com/95b30f963245ccd8d40cf96dc6dd3c4a01f5c658349e08d1e5c7d22519e45eae/68747470733a2f2f696d672e736869656c64732e696f2f646973636f72642f343239323034303235363738373537383939)

*If you need help or have questions, don't hestiate to contact Me. Best done if you join the above mentioned Discord server or (if you found something) create an issue in Github. Also pull request for fixes of course are welcome.*

Of course not fully finished is it still able to do the most important things. This includes:

- Nebucord WebSocket API

    - Setup and run bot(s)
    - Set status for bots
    - Simple control commands
    - Callback classes to intercept Discord gateway events
    - Changing default internal command behaviours
    - Setting user id's for bot controlling
    - Configurable by parameter or by .ini file
    - Customable gateway intents
    - Application and interactions API
- Nebucord REST API

    - Model oriented interface on data receiving
    - Application and interactions API
    - Followup Messages for interactions
    - Complete Discord REST API
    - Configurable by parameter or by .ini file
- What's missing

    - Many error checking
    - Way more better logging and debugging options
    - Multithreading (if applicable, thanks to [bitnykk](https://github.com/bitnykk) for the idea)

Default and available parameters
--------------------------------

[](#default-and-available-parameters)

ParameterConfig nameINI config nameDefault valueBot tokentokenbottoken(string)*empty*ACL user snowflakesctrluseracl(array)\[\]WS connection retrieswsretrieswebsocket.retries(integer)3Default GW intent bitmask\*intentsintents.\*(integer)3276541 / (boolean)true\*DM on failuresdmonfailureswebsocket.dmonfailures(boolean)true**\*Note:**
The intent bitmask defaults to be everything is true except `GUILD_MEMBERS`, `GUILD_PRESENCES`, `GUILD_MESSAGES` and `MESSAGE_CONTENT`. These four options has to be manual set to `true` and they have to be activated in the Bot preferences on the Discord application management webpage. The bitmask is `3276799` if everything set to true or for config as parameter.

**Note:**
Configuration by parameter has priority to configuration by .ini file.

Requirements
------------

[](#requirements)

Additional Composer packages are required in order to run Nebucord.
Of course these can also be installed without Composer, but you have to include the SPL autoloader of the packages as well.

*The recommended way is to use Composer.*

**Package informations:**

- [Connfetti-IO on Github](https://github.com/Eurobertics/Connfetti-IO)
- [Connfetti-INI on Github](https://github.com/Eurobertics/Connfetti-INI)

Install
-------

[](#install)

**By composer:**

```
user@linux:~# composer require eurobertics/nebucord

```

---

**By Docker (more information can be found on [Nebucord Docker Hub](https://hub.docker.com/repository/docker/eurobertics/nebucord)):**

```
user@linux:~# docker pull eurobertics/nebucord:latest

```

---

**By GitHub Packages (more information can be found on [GitHub Pulling container images](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-container-registry#pulling-container-images)):**

```
docker pull ghcr.io/eurobertics/nebucord:latest

```

**Note:**
If you want use .ini configuration, you have to put your .ini File (`nebucord.ini` i. e.) in the mounted directory for your Docker instance and set the path to the path of the docker working directory. You can find more information about this on the [Nebucord Docker Hub Page](https://hub.docker.com/repository/docker/eurobertics/nebucord).

---

**By GIT:**
Simple clone this repository and use the native autoloader file in ./src Directory.

```
user@linux:~# git clone https://github.com/Eurobertics/Nebucord.git

```

**Note:**If you use the library without composer, you just can include the native autoloader:

```
include "src/nebucordAutoloader.php";
```

**Note:**You have to include the native autoloader of the dependencie packages as well. See package dependencies above.

---

Example usage - WebSocket API
-----------------------------

[](#example-usage---websocket-api)

The WebSocket API is designed to run as a PHP CLI program.

Usage websocket API, minimalistic example:

```
