Jump to content
  • Sky
  • Blueberry
  • Slate
  • Blackcurrant
  • Watermelon
  • Strawberry
  • Orange
  • Banana
  • Apple
  • Emerald
  • Chocolate
  • Charcoal

OC - "net" API [basic DNS system]

Recommended Posts

net API - The most basic DNS system

How this works:

  • The DNS server constantly broadcasts out its information every 2 seconds on the specified port
  • The client APIs have a function to search for the next DNS server (they wait for the above information) which then sets the table containing the information to net.foundServer
  • Now the client APIs have the ability to call net.setDNS(net.foundServer.address) to lock to that DNS
  • With that the client APIs can now register and delete their URLs on this DNS server
  • Every other client who has that DNS server locked on too can look up your modem's address by calling net.resolve(url) [returns true/false and the message (either an error or the address)]


DNS server:

  • A setup with color support (it logs stuff on the screen and uses colors for that too)
  • Of course a wireless network card
  • My multitasking API which should be saved as "oc_multitasking_api"
  • At best: openOS (because it uses the keyboard and event api)


  • The api
  • A wireless network card of course
  • And maybe an idea on how you can make use of it
  • At best: openOS (because it uses the event api)

How to set it up:

  • Build a server / computer for the DNS server (look at the requirements)
  • Buld a computer for the client(s) (look at the requirements)
  • Create a new program to use the API
    NOTE: At boot, the API doesn't have a DNS server registered, you NEED to register it using net.listenForDNS() or directly putting in an address
    local net = require("net") --This needs to be called for every program which uses the API, which is normal
    net.listenForDNS() --This wont stop until it gets a message from a DNS server
    net.setDNS(net.foundServer.address) --Set the locked DNS to the actual address of the found server



  • listenForDNS() : Waits for a DNS server to broadcast it's information
  • registerURL([STRING]): Registers an URL for your modem's address  (Returns true/false with an (error-) message)
  • removeURL([STRING]): Removes the given URL from the DNS if it's yours (Returns true/false with an (error-) message)
  • setDNS([STRING]): Set the locked DNS' address to the given one
  • getDNS(): Get the currently locked DNS' address (returns the address of the DNS server's modem)
  • getPort(): Get the port which the API looks for messages from the DNS server
  • setPort([NUMBER]): Set the port which the API looks for messages from the DNS server
  • resolve([STRING]): Try to get the modem address of the given URL (Returns true/false with the address or an error message)
  • getURL([STRING]): The reverse of the above function (Returns true/false with the URL or an error message)
  • getAll(): Returns a table with every URL and the associated address on the DNS server (key = URL, value = address)


DNS server:


net API:




The DNS server does currently not save the DNS list on reboot and it looks like it stops broadcasting when the computer stays on when closing the server / game.

Link to post
Share on other sites

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.

Reply to this topic...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.


  • Create New...

Important Information

By using this site, you agree to our Terms of Use and Privacy Policy.