[MOD 0.15] Computer Mods

[Relik]

Computer is a modification for Factorio that’s all about computer programming. It allows you to write programs using the Lua programming language.



Name: Computer Core
Description: This the main part of computer mod, is required to use another computer module
License: MIT
Version: 1.2.0
Factorio Version: 0.15.x
Category: Utility
Author: Relik
Downloads: Mod portal
Github: Relik77/factorio_computer_core

Long description

This the main part of computer mod, is required to use another computer module

Computer is a modification for Factorio that’s all about computer programming.
It allows you to write programs using the Lua programming language.

For modders, computer adds an interface for you to add your own APIs to the operating system (see below).

Command Line Usage

The command line simulates a basic shell

These shell commands are internally defined.
Enter help to see this list.\
Type help apis to see list of available APIs.\
Type help name to find out more about the API called "name".

Some main commands :

cat <filename> ... : concatenate files and return result
cd <dirname> : Moving in the directory tree
cp <srcfile> <dstfile> : copy a file
edit <file> : Edit the file
help [apis | apiname] : Print help
label <get|set|clear> [<label>] : Label is a built in program for computers that will create a label for the computer
ls : List directory contents
mkdir <dirname> : Make directories
rm <file> : remove files or directories
run <file> : Run a script file
tree : list contents of directories in a tree-like format
position : Return the current computer position
waypoint : Edit saved waypoints

Computer Label

You can add a label for any computer with label set my_label.\
Adding a label will create a mount point for this computer and make it available to any other computer.
So you can copy files from one computer to another.

Core APIs

An API (Application Programming Interface) is a collection of code that, rather than being run directly by the user as a program, is meant to be used by other programs (your program).

Computer itself ships with a collection of APIs :

os API : The Operating System API allows for interfacing with the Lua based Operating System itself. Exemple: os.wait(callback, seconds) wait a number of seconds before executing callback function.
term API : The Terminal API provides functions for writing text to the terminal. Exemple: term.write(text) writes text to the screen
lan API : The LAN API provides functions to communicate using circuit network
wlan API : The WLAN API provides functions to communicate using wirless network

More information available with help os and help term.

Change Log

v1.1.0

• Add inline command "position"
• Add waypoints support

v1.0.0

• Initial release

Name: Onboard Computer
Description: Add a board computer to your cars and write a Lua program to give them an AI
License: MIT
Version: 0.2.0
Factorio Version: 0.15.x
Category: Logistics
Author: Relik
Downloads: Mod portal
Github: Relik77/factorio_onboard_computer
Dependencies:computer_core, any mod that adds an inventory grid to vehicles (eg: Vehicle Grid, VehicleGrids, 5Dim's mod - Vehicle...)

Todo:
What should be done in the future:
- Military computer : provides functions to detect and engage your enemies (waiting for Factorio v0.16 which should fix a bug with the shooting function)

Long description

OnBoard APIs

OnBoard mod add an On-board computer item, placed in the equipment grid of a car it gives access to an API car\
The car API provides these functions
- car.hasPassenger() : Return true if a player is in the car
- car.getPosition() : Returns the current position of the car
- car.getSpeed() : Return the speed of the car in km/h
- car.getOrientation() : Return the orientation of the car
- car.scanSurface(position) : Scan a position in a radius of 20 tiles, return true or false if the car will collides at and return the tile name
- car.getFuel() : Returns the fuel in the tank of the car
- car.startEngine() : Starts the car engine
- car.stopEngine() : Stop the car engine
- car.accelerate() : Press the gas pedals
- car.brake() : Press the brake pedal
- car.reverse() : Put the car into reverse
- car.turnRight() : Turn the steering wheel to the right
- car.turnLeft() : Turn the steering wheel to the left
- car.straight() : Put back the wheels straight
- car.getCargo() : Returns the contents of the car
- car.trafficInformation() : Scan trafic in a radius of 20 tiles, return entities information
- car.getWaypoint(name) : Find a waypoint by its name, and return its position

Change Log

v0.2.0

• Add API methods: car.getCargo(), car.trafficInformation() and car.getWaypoint(name)

v0.1.0

• Initial release

Normally the mod is multiplayer compatible
I try to test all cases of potential crash in order to offer you a system as stable as possible, but if you detected let me know.

If you have suggestions or design images (this is not my specialty), you're welcome

[lost]

Hi Relik

I might be interested to work on your computer modes in Github. I can fork both repos, but it might be more convenient for me to have write access to the existing one. What do you think? My GitHub is lostmsu.

My final goal is making a self-expanding factory. I'd be interested in a more direct contact, if you have time. Like Skype, or even meet in person, if you are in Seattle's greater area.

[Relik]

New version done,
Add a placeable computer on the ground and 2 new APIs (LAN and WLAN)


@lost I answered you by private message, I do not know if you saw

[Sad_Brother]

Hi!
I was able to open gauntlet console at last.
But how to open Placeable Computer's console?
And Onboard Computer's by the way, please...

[iliketanks1998]

Ctrl + click opens the computers on the ground, and on-board computers are a part of the sister mod - here - https://mods.factorio.com/mod/onboard_computer .

[iliketanks1998]

Is there a function/method to get text input from the user via the console? I haven't found one in the term 'library' and read() is undefined.

[SereneRebel]

Excellent mod just one question, how quickly does the code actually execute?
does it run as much as it can during a single tick? eg until os.wait() is called
I'd like to know if it is possible to write out "1 tick" outputs as i have a use that would require being able to send a stream of signals

[Relik]

Hi,

Sorry to answer only now, I'm watching the other feeds (mods.factorio.com & github) and since there was almost nothing happening here I was spending less :/
(Ideally, an email alert system could be set up on mods.factorio.com and forums.factorio.com ^^)

So, yes it run as much as it can during a single tick.
For os.wait, I just converted the ticks into seconds because it seemed more convenient to use for most players.
But in the end it just calculates the tick to which the function should be recalled, and if it has already passed it the call anyway.
So:

Code: Select all

os.wait(function()
-- Some code
end, 0)

Will execute the callback function at the next tick