AE2CC Bridge

AE2CC Bridge adds a simple peripheral block that may be used to access an Applied Energistics 2 ME system from ComputerCraft computers.

Important

This mod is inherently unbalanced. The peripheral access to the ME system provided by this mod allows players to circumvent channel limitations and perform arbitrary logic at effectively no energy cost.

Note

Currently, the peripheral only exposes a fairly small API. If you find that functionality you need is missing, please file a feature request in our issue tracker.

Peripheral API - Crafting (Functions)

`getAvailableObjects()`

Returns a list of objects that are currently available in the ME system.

Returns

{ { type = string, id = string, displayName = string, amount = number }... } – a table with a list of objects available in the ME system

`getCraftableObjects()`

Returns a list of objects that can be crafted by the ME system.

Returns

{ { type = string, id = string, displayName = string }... } – a table with a list of objects that can be crafted by the ME system

`getCraftingCPUs()`

Returns a list of crafting CPUs available in the ME system.

Returns

{ cpu... }

where cpu is a table defined as follows:

Key	Type	Description
`availableCoProcessors`	`number`	The number of available co-processors.
`availableStorage`	`number`	The amount of available crafting storage.
`selectionMode`	`string`	The selection mode of the CPU. (Either `ANY`, `MACHINE_ONLY`, or `PLAYER_ONLY`.)
`jobStatus`	`string?`	Information about the currently running job.
`name`	`string?`	The custom name of the CPU.

where jobStatus is a table defined as follows:

Key	Type	Description
`totalObjects`	`number`	The total amount of objects that will be crafted during the job.
`craftedObjects`	`number`	The amount of crafted objects.
`elapsedNanos`	`number`	The time (in nanoseconds) that has elapsed since the job has started.
`systemID`	`string?`	The ID given to the running job by the ME system.
`output`	`output`	The job's output.

where output is defined as follows:

Key	Type	Description
`amount`	`number`	The number of requested objects.
`type`	`string`	The type of the object.
`id`	`string`	The ID of the object.
`displayName`	`string`	The display name of the object.

Remarks

For technical reasons, determining the systemID may fail in some cases. If this happens, the systemID is not included and an error is logged. If you are using up-to-date versions of AE2 and AE2CC Bridge, please make sure this issue is known in the issue tracker for your versions.

`getIssuedCraftingJobs`

Returns a list of unfinished crafting jobs issued by the peripheral.

Returns

{ { state = string, jobID = string, systemID = string? }... } – a table with a list of objects for each unfinished job issued by the peripheral.

Remarks

For a job to be included in the output, its state must either be SCHEDULED or STARTED. If the job has started running, an additional systemID is field is included. This ID is the ID given to the running job by the ME system (opposed to the jobID which is local to a peripheral).

`scheduleCrafting(type, id, amount)`

Schedules a crafting job.

Parameters

type: string – the type of the object to craft ("fluid" or "item")
id: string – the ID of the object to craft
amount: number – the amount of the object to craft

Returns

string – a unique ID representing the crafting job

Remarks

Note: This method is deliberately named scheduleCrafting as scheduling a crafting job does not actually start a crafting process immediately. Instead, the crafting job is started at some point in the future when the ME system is ready.

To work with crafting jobs, it is necessary to understand their lifecycle.

flowchart LR
Scheduled --> Started
Started --> Done
Started --> Cancelled
Scheduled --> Cancelled

Initially, a newly created crafting job's state is SCHEDULED. During creation, the ME system is instructed to prepare for the crafting job (which includes calculating) the exact crafting plan.

Once the system has finished all necessary preparations, the crafting job's state changes to STARTED. The ae2cc:crafting_started event can be used to listen to this state change.

Finally, when the crafting job is finished, it's state changes to DONE and the ae2cc:crafting_done event is fired.

Additionally, if the job is cancelled or an error occurs at any point of the crafting job's lifecycle, the ae2cc:crafting_cancelled event is fired.

Peripheral API - Crafting (Events)

`ae2cc:crafting_cancelled`

The ae2cc:crafting_cancelled event is fired when a crafting job is cancelled.

Return Values

string – the name of the event
string – the ID of the cancelled crafting job
string - the reason for the cancellation

Remarks

The reason for the cancellation is always one of:

Value	Description
`CANCELLED`	The job was cancelled (either manually or by a machine).
`CPU_NOT_FOUND`	The selected crafting CPU was not found.
`INCOMPLETE_PLAN`	No crafting plan could be calculated for the job.
`NO_CPU_FOUND`	No crafting CPU to execute the job was found.
`CPU_BUSY`	The selected crafting CPU is busy.
`CPU_OFFLINE`	The selected crafting CPU is offline.
`CPU_TO_SMALL`	The selected crafting CPU is too small to process the job.
`MISSING_INGREDIENT`	Could not obtain one of the ingredients needed for the job.

`ae2cc:crafting_done`

The ae2cc:crafting_done event is fired when a crafting job is done.

Return Values

string – the name of the event
string – the ID of the finished crafting job

`ae2cc:crafting_started`

The ae2cc:crafting_started event is fired when the state of a previously SCHEDULED crafting job changes to STARTED.

Return Values

string – the name of the event
string – the ID of the started crafting job

Peripheral API - Energy (Functions)

`getAveragePowerInjection()`

Returns the average energy injected into the ME system per tick, for the last 10 ticks.

Returns

number – the average injected energy

`getAveragePowerUsage()`

Returns the average power drain over the past 10 ticks.

Returns

number – the drained power

`getChannelPowerUsage()`

Returns the current idle power usage of channels in the ME system.

Returns

number – the power used by idle channels

`getIdlePowerUsage()`

Returns the current calculated total idle power usage of the ME system.

Returns

number – the power drained from the ME system each tick while idle

`getMaxStoredPower()`

Returns the (estimated) maximum amount of power that can be stored in the ME system.

Returns

number – the estimated maximum stored power

`getStoredPower()`

Returns the (estimated) amount of power stored in the ME system.

Returns

number – the estimated stored power

Versioning

AE2CC Bridge uses a custom versioning scheme that follows the spirit of the SemVer 2.0.0 specification.

Given a version number WORLD.API.FEATURE-MC-LOADER-TARGET.PATCH, increment the:

WORLD version when you make save-game incompatible changes,
API version when you make incompatible API changes,
FEATURE version when you update functionality in a backwards compatible manner
TARGET version when you update to a backward incompatible version of your loader
PATCH version when you make backwards compatible bug fixes

The MC version should always be the version string of the targeted version of Minecraft. If multiple Minecraft versions are supported by a single mod version, typically the oldest supported version string should be chosen.

Similarly, the LOADER version should be used to indicate which mod loader the version was written for (e.g. "FABRIC").

Supported versions

Minecraft Version	State
1.20	Mainline
1.18	Active Development
1.18	Active Development

This is the mainline branch for the development of AE2CC Bridge which usually targets the most recent Minecraft version. The development for other versions of Minecraft happens in the repositories and branches linked in the table above.

Support Cycle

State	Description
Mainline	The primary development branch
Active Development	This version still receives all updates
Maintenance Mode	This version still receives fixes but no new features
Unsupported	This version is unsupported and does not receive any updates

Building from source

Setup

This project uses Gradle's toolchain support to detect and select the JDKs required to run the build. Please refer to the build scripts to find out which toolchains are requested.

An installed JDK 1.8 (or later) is required to use Gradle.

A local installation of CC:Restitched is required to build this mod. The recommended way to create one is going to the submodule under deps/cc-restitched and calling:

gradlew jar publishToMavenLocal

Building

Once the setup is complete, invoke the respective Gradle tasks using the following command on Unix/macOS:

./gradlew <tasks>

or the following command on Windows:

gradlew <tasks>

Important Gradle tasks to remember are:

clean - clean build results
build - assemble and test the project
runClient - runs the development client
runServer - runs the development server

Additionally tasks may be used to print a list of all available tasks.

License

Copyright (c) 2022-2024 Leon Linhart

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Name		Name	Last commit message	Last commit date
Latest commit History 121 Commits
.github		.github
.idea		.idea
build-logic		build-logic
docs/changelog		docs/changelog
gradle		gradle
src/main		src/main
.gitattributes		.gitattributes
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
build.gradle.kts		build.gradle.kts
gradle.properties		gradle.properties
gradlew		gradlew
gradlew.bat		gradlew.bat
settings.gradle.kts		settings.gradle.kts

License

TheMrMilchmann/AE2CCBridge

Folders and files

Latest commit

History

Repository files navigation

AE2CC Bridge

Peripheral API - Crafting (Functions)

getAvailableObjects()

Returns

getCraftableObjects()

Returns

getCraftingCPUs()

Returns

Remarks

getIssuedCraftingJobs

Returns

Remarks

scheduleCrafting(type, id, amount)

Parameters

Returns

Remarks

Peripheral API - Crafting (Events)

ae2cc:crafting_cancelled

Return Values

Remarks

ae2cc:crafting_done

Return Values

ae2cc:crafting_started

Return Values

Peripheral API - Energy (Functions)

getAveragePowerInjection()

Returns

getAveragePowerUsage()

Returns

getChannelPowerUsage()

Returns

getIdlePowerUsage()

Returns

getMaxStoredPower()

Returns

getStoredPower()

Returns

Versioning

Supported versions

Support Cycle

Building from source

Setup

Building

License

About

Topics

Resources

License

Stars

Watchers

Forks

Releases 5

Contributors 3

Languages

`getAvailableObjects()`

`getCraftableObjects()`

`getCraftingCPUs()`

`getIssuedCraftingJobs`

`scheduleCrafting(type, id, amount)`

`ae2cc:crafting_cancelled`

`ae2cc:crafting_done`

`ae2cc:crafting_started`

`getAveragePowerInjection()`

`getAveragePowerUsage()`

`getChannelPowerUsage()`

`getIdlePowerUsage()`

`getMaxStoredPower()`

`getStoredPower()`