Awesome Open Source
Awesome Open Source


July 2022 update: beta demo available at

Let me know your interest on the GitHub discussions thread!

Welcome to Delaford. An online, 2D medieval game using JavaScript and HTML5. Game screenshot

Getting Started

First, fork the repository. Then, go into your favorite terminal.

git clone [email protected]:YOUR_USERNAME/game.git
cd game
npm install
npm run serve

npm run serve will start the development server and watch for changes on the client-side code inside the src folder and otherwise elsewhere applicable.

Now, while still inside the game folder, open another terminal session in that same location. Type and run npm run dev:node. This will start the Node.js game server.

If you want to debug, type npm run ndb. ndb is Google Chrome's Node Debugging tool which allows Node.js programs to be easily debugged and see all its context and variables. Highly recommended for a much easier time.

Now you may visit http://localhost:8080 to login and start developing!

For a better time, make sure to join the Discord channel to talk to other developers for help and exclusive dicussions!

Please be aware of a possible scam in regards to Delaford that promises money for testing or similar action.


Please check out our guide on how you can actively participate in the development of this medieval game. It's pretty easy and fun!

Systems and Engines

Here are the types of things I will be adding as a minimum viable product (alpha). Not too over the top but enough to cover the basics until more is added. Each section links to a project which will contain its sub-tasks within.

What does a checkmark mean?

When an item is checkmarked, it means the basic foundation is in place but not necessarily complete. For example, Inventory is checkmarked but it currently only supports weapons. You can help fix that.

  • Player
    • [x] Walking / pathfinding
    • [x] Context-menu / Actions
    • [ ] Health and stats
    • [x] Inventory
    • [x] Character wear
    • [ ] Your first quest
  • User Interface
    • [x] Inventory tab
    • [ ] Quests tab
    • [x] Chatbox (for players and actions)
    • [x] Character wear tab
    • [x] Overall look & feel
  • NPC
    • [x] Trading (Shops)
    • [ ] Dialog Interaction
    • [x] Walking around
    • [x] Banking
  • Monsters
    • [ ] Battle System
    • [ ] Looting
    • [ ] Spawning
  • Networking
    • [x] Players see each other
    • [x] Non-playable characters
    • [ ] Monsters
    • [ ] Player trading
    • [x] Items
  • World
    • [x] Respawn system
    • [ ] Player versus Player
    • [ ] Resource skills
      • [x] Mining
      • [ ] Smithing (Almost finished)
      • [ ] Fishing
      • [ ] Cooking

Once all of these items are checked, Delaford will be stable without breaking changes. But for the time being, please jump in and help add some of these features -- if you'd like!


Learning how to debug in this game is critical in order to interact with the Node.js server and to the client. Your primary source should be the ndb tool from Google. It is an improved debugging experience witch drastically improved client-side debugging.



Delaford contains work from multiple sources not organically made by contributions from Delaford directly.

Website Status

Website is not currently up. The number of users did not justify the monthly charge.

Possible Scam Notice

Delaford contributors nor anyone associated with Delaford will never contact you in regards testing or instructing you to downloading anything in regards to the development of the game for the reward of payment or digital currency such as cryptocurrency.

We have had verifiable reports of users pretending to be owners of Delaford promising money if they download a folder with the repository's contents inside. Please be aware.

Alternative Project Comparisons
Related Awesome Lists
Top Programming Languages

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Javascript (1,157,171
Video Game (83,626
Canvas (10,794
2d Graphics (9,119
Game Development (7,474
Inventory (5,835
Game Engine (4,839
Rpg (3,244
Roguelike (1,200
Mmorpg (1,195
Multiplayer Game (688
Javascript Game (672
Browser Game (373
Rpg Game (257
Dungeon Crawler (55
Nethack (30
Multi User Dungeon (29
Ultima Online (24
Medieval (21
Gurps (7
Angband (4