←  General

ComputerCraft | Programmable Computers for Minecraft

»

CCEmuX - A modular ComputerCraft emulator

apemanzilla's Photo apemanzilla 10 Jun 2018

Posted Image
CCEmuX
Hello everyone! After several years of work by many contributors, I'm proud to announce the first official release of CCEmuX, a new CC emulator written in Java with many unique features.
Posted Image
Features
Spoiler
Download
The CCEmuX launcher can be downloaded from our website. Updates will be applied automatically, and you will be prompted for whether you want to use ComputerCraft or CC-Tweaked on the first run (this can be changed later by editing the launcher configuration).
Getting started
When you start CCEmuX, a single computer will be opened by default. From here, you can use the emu program to perform other emulator actions:
  • emu open - Opens a new emulator window with the next computer ID, or a specific ID if you pass it as an argument.
  • emu close - Closes the current emulator window. If this is the only computer, it will stop the emulator.
  • emu data - Opens the CCEmuX data folder in your file manager. This can be used to browse computer files, add custom plugins or resources, or edit the config files externally.
  • emu config - Opens the configuration window. From here you can change every setting for CCEmuX and your plugins. (Note that only the AWT renderer currently supports this - for other renderers, use emu data and then edit the configuration files).
  • help emu - Read the included help file, describing all of these commands in-depth.
Source code, bug reports, suggestions
You can view the source code, report issues, or make suggestions through GitHub.
Edited by apemanzilla, 10 June 2018 - 10:21 PM.
Quote

LDDestroier's Photo LDDestroier 11 Jun 2018

Posted Image

...I guess I can finally get CCEmuRedux off my desktop. +1'd.


EDIT: It seems that mouse_scroll events are doubled.
Edited by LDDestroier, 11 June 2018 - 06:53 PM.
Quote

SquidDev's Photo SquidDev 11 Jun 2018

I've been using this emulator for well over a year (possibly almost 2 years now) so it's amazing to see it finally get a forum post!

The configurable screen dimensions are insanely useful (both for emulating a turtle and just having more screen space). I do like how the high-resolution font (<3 BombBloke) makes it all feel that wee bit more fancy.

View PostLDDestroier, on 11 June 2018 - 04:25 AM, said:

EDIT: It seems that mouse_scroll events are doubled.
Should be fixed now - apparently AWT is a little funky about firing events. The launcher should fetch the latest version, so running it twice (once to download, second time to use) should fix it all.
Quote

blunty666's Photo blunty666 16 Jun 2018

This is really good! Seems to work with my existing CC code without any issues.

It might be worth mentioning in the OP about the lua directory in the data folder where you can put shared code for all computers? I managed to find it but only by accident :)
Quote

SquidDev's Photo SquidDev 16 Jun 2018

View Postblunty666, on 16 June 2018 - 11:29 AM, said:

It might be worth mentioning in the OP about the lua directory in the data folder where you can put shared code for all computers? I managed to find it but only by accident :)
I assume you're referencing assets/computercraft/lua? This effectively acts the same way as CC's built-in resource pack support, though I'm not really sure how well documented that is either. While I'd rather like the emulator to be as self-explanatory as possible, there's definitely some bits we need to knuckle down and write something about (though ape's done a jolly good job in the OP).
Quote

LoganDark2's Photo LoganDark2 16 Jun 2018

Oh hey, this has been upgraded.
Quote

apemanzilla's Photo apemanzilla 17 Jun 2018

View PostLoganDark2, on 16 June 2018 - 05:36 PM, said:

Oh hey, this has been upgraded.

Yeah, there's been a few minor fixes. The launcher should automatically apply them.
Quote

LoganDark2's Photo LoganDark2 17 Jun 2018

View Postapemanzilla, on 17 June 2018 - 04:47 AM, said:

View PostLoganDark2, on 16 June 2018 - 05:36 PM, said:

Oh hey, this has been upgraded.

Yeah, there's been a few minor fixes. The launcher should automatically apply them.

I mean, the version that I had prior to noticing this was dated back before `emu config` was a thing.
Quote

LDDestroier's Photo LDDestroier 22 Jun 2018

Another thing, sometimes after terminating a few times, key events will occasionally stop working. Mouse clicks will work, but not any keys.
Quote

Lignum's Photo Lignum 22 Jun 2018

View PostLDDestroier, on 22 June 2018 - 07:28 AM, said:

Another thing, sometimes after terminating a few times, key events will occasionally stop working. Mouse clicks will work, but not any keys.
Please file any issues on GitHub. It's easier for us when everything's in one place.
Quote

SquidDev's Photo SquidDev 22 Jun 2018

View PostLDDestroier, on 22 June 2018 - 07:28 AM, said:

Another thing, sometimes after terminating a few times, key events will occasionally stop working. Mouse clicks will work, but not any keys.
Hrmrm, I'm unable to reproduce this at all. It would be really useful if you could do something like while true do print(coroutine.yield()) and try to reproduce - just so we can see what's being queued and what isn't.
Quote

biggest yikes's Photo biggest yikes 30 Jun 2018

View PostSquidDev, on 22 June 2018 - 06:18 PM, said:

Hrmrm, I'm unable to reproduce this at all. It would be really useful if you could do something like while true do print(coroutine.yield()) and try to reproduce - just so we can see what's being queued and what isn't.
I think this might be a similar (?) issue, so I figured I'd put it here.
Spoiler

Edited by Atenefyr, 05 July 2018 - 10:36 PM.
Quote

SquidDev's Photo SquidDev 07 Jul 2018

View PostLDDestroier, on 22 June 2018 - 07:28 AM, said:

Another thing, sometimes after terminating a few times, key events will occasionally stop working. Mouse clicks will work, but not any keys.

View PostAtenefyr, on 30 June 2018 - 11:22 PM, said:

I think this might be a similar (?) issue, so I figured I'd put it here.
Sorry for the delay: this should be fixed in the latest version. Can you both update and double check this works for you? (you'll need to run the emulator, wait for it to download and then restart it). It's possible I've missed some other cases, so do tell me if it's still occurring!
Quote

SquidDev's Photo SquidDev 29 Jul 2018

In case people are interested, I've started writing some documentation on the basic functionality of the emulator, in the hope that it'll clear up some of the basic questions. It doesn't cover any of the advanced stuff yet (peripherals, resource packs), but hopefully provides a nice reference point.

If people have any thoughts, or things they'd like to see documented, do let me know - either here or on the issue tracker.
Quote

SquidDev's Photo SquidDev 13 May 2019

Almost a year later, but I've finally fleshed out the documentation a little! We've now got a pages dedicated to peripherals, the ccemux API, and a couple of other things which didn't show up elsewhere. Hopefully this should alleviate the confusion a little, but do let us know if there's anything which you feel could do with further explanation!
Quote

Pyuu's Photo Pyuu 18 Jul 2019

Is it intentional for it to flicker so much when typing? Or is that normal for CC?
Quote

SquidDev's Photo SquidDev 18 Jul 2019

View PostPyuu, on 18 July 2019 - 06:22 PM, said:

Is it intentional for it to flicker so much when typing? Or is that normal for CC?
IIRC the refresh rate for CCEmuX is a higher than what you get within Minecraft, which might make any potential flicker a little more obvious. That said, I've never had much of a problem with it, so interesting that you're experiencing it...
Quote

SquidDev's Photo SquidDev 28 Jan 2020

Ho ho, it's been a while since I posted here, but thought it would be worth mentioning some of the recent changes in CCEmuX:
  • You can now take screenshots! Use ccemux.screenshot() (or press F2) to take a screenshot. These can be accessed by running emu data, and then navigating to the screenshots folder.
  • You can now point CCEmuX at your Minecraft world's computer/ folder, or even a single computer folder. This should make it easier to use CCEmuX anywhere, rather than forcing you to put all your projects within the data directory. There's more information on the website on how to do that.

Edited by SquidDev, 28 January 2020 - 10:35 PM.
Quote