rotnetz Documentation

rotnetz is a Lua library for ComputerCraft that enables remote procedure calls (RPC) between computers over the rednet network.

Getting Started

Overview

rotnetz provides a client-server architecture where:

• Hosts expose methods that can be called remotely
• Clients make requests to hosts and receive responses

For a detailed explanation of how the networking works, including the request-response cycle and protocol usage, see the Networking Architecture document.

Quick Example

Host Setup

Client Usage

Documentation

• Networking Architecture - Detailed explanation of how RPC works, protocol usage, and message flow
• Host API - API reference for creating and configuring hosts (see Request Processing for detailed information on how hosts handle requests)
• Client API - API reference for making remote calls (see Response Handling for detailed information on handling responses)

Key Concepts

1. Synchronous vs Asynchronous: Understand when to use blocking vs non-blocking calls
2. Protocol Management: Learn about the different protocols used for requests and responses
3. Error Handling: Always check the state field of responses
4. Threading Model: Hosts use multiple threads for receiving and processing requests
5. Response Handling: Responses are sent back via dedicated protocols

For more details on these concepts, refer to the Networking Architecture document.