⚠️ ⚠️ READ FIRST ⚠️ ⚠️

[UplandJacob]

Important notes before creating an issue or commenting

Read the contributing guidelines

Please make a separate issue for every bug or feature. We can't keep track of issues if things are mixed together.

Check to make sure your issue has not been created before. Also check closed issues

If you have a question, create a discussion under Q&A instead of an issue

Do not ask unrelated questions or report unrelated bugs in issue threads. Use discussions or create a new issue.

Frequently Asked Questions/Problems

When will xx version release?

We don't know exactly. If we do, there will be a date set on the milestone (which is shown next to issues which are fixed in that version).

Where can I download it?

Downloads are in the releases section of this repository. Click on the 'Assets' dropdown, then Tuff_Client_Offline_WASM.html (recommended) or Tuff_Client_JS.html (JS - not recommended)

When will you release the source?

We're never going to.

It won't load / JavaScript is blocked

Either find an unblocked website where TuffClient is hosted (we don't have a list, sorry), or use this loader (paste it in your address bar - doesn't save settings, servers, worlds, etc):

data:text/html;charset=utf-8;base64,PCFET0NUWVBFIGh0bWw+DQo8aHRtbCBsYW5nPSJlbiI+DQo8aGVhZD4NCjxtZXRhIGNoYXJzZXQ9IlVURi04Ij4NCjx0aXRsZT5Hb29nbGUgQ2xhc3Nyb29tPC90aXRsZT4NCjxzdHlsZT4NCiAgICBib2R5IHsgZm9udC1mYW1pbHk6IEFyaWFsLCBzYW5zLXNlcmlmOyBtYXJnaW46IDIwcHg7IH0NCiAgICBpbnB1dCwgYnV0dG9uIHsgbWFyZ2luLXRvcDogMTBweDsgfQ0KPC9zdHlsZT4NCjwvaGVhZD4NCjxib2R5Pg0KDQo8aDI+VXBsb2FkIGFuIEVhZ2xlcmNyYWZ0IEhUTUwgRmlsZSAobG9jYWwgd29ybGRzIHdpbGwgbm90IGJlIHNhdmVkIGFjcm9zcyBzZXNzaW9ucyk8L2gyPg0KDQo8aW5wdXQgdHlwZT0iZmlsZSIgaWQ9ImZpbGVJbnB1dCIgYWNjZXB0PSIuaHRtbCwuaHRtLHRleHQvaHRtbCI+DQo8YnI+DQo8YnV0dG9uIGlkPSJvcGVuQnRuIiBkaXNhYmxlZD5PcGVuIGluIE5ldyBUYWI8L2J1dHRvbj4NCg0KPHNjcmlwdD4NCmNvbnN0IGZpbGVJbnB1dCA9IGRvY3VtZW50LmdldEVsZW1lbnRCeUlkKCdmaWxlSW5wdXQnKTsNCmNvbnN0IG9wZW5CdG4gPSBkb2N1bWVudC5nZXRFbGVtZW50QnlJZCgnb3BlbkJ0bicpOw0KbGV0IGZpbGVCbG9iVXJsID0gbnVsbDsNCg0KLy8gSGFuZGxlIGZpbGUgc2VsZWN0aW9uDQpmaWxlSW5wdXQuYWRkRXZlbnRMaXN0ZW5lcignY2hhbmdlJywgZnVuY3Rpb24gKCkgew0KICAgIGNvbnN0IGZpbGUgPSB0aGlzLmZpbGVzWzBdOw0KICAgIGlmICghZmlsZSkgew0KICAgICAgICBvcGVuQnRuLmRpc2FibGVkID0gdHJ1ZTsNCiAgICAgICAgZmlsZUJsb2JVcmwgPSBudWxsOw0KICAgICAgICByZXR1cm47DQogICAgfQ0KDQogICAgLy8gVmFsaWRhdGUgZmlsZSB0eXBlDQogICAgaWYgKCFmaWxlLnR5cGUuaW5jbHVkZXMoJ2h0bWwnKSAmJiAhZmlsZS5uYW1lLmVuZHNXaXRoKCcuaHRtbCcpICYmICFmaWxlLm5hbWUuZW5kc1dpdGgoJy5odG0nKSkgew0KICAgICAgICBhbGVydCgnUGxlYXNlIHNlbGVjdCBhIHZhbGlkIEhUTUwgZmlsZS4nKTsNCiAgICAgICAgdGhpcy52YWx1ZSA9ICcnOw0KICAgICAgICBvcGVuQnRuLmRpc2FibGVkID0gdHJ1ZTsNCiAgICAgICAgcmV0dXJuOw0KICAgIH0NCg0KICAgIC8vIFJldm9rZSBvbGQgQmxvYiBVUkwgaWYgZXhpc3RzDQogICAgaWYgKGZpbGVCbG9iVXJsKSB7DQogICAgICAgIFVSTC5yZXZva2VPYmplY3RVUkwoZmlsZUJsb2JVcmwpOw0KICAgIH0NCg0KICAgIC8vIENyZWF0ZSBhIEJsb2IgVVJMDQogICAgZmlsZUJsb2JVcmwgPSBVUkwuY3JlYXRlT2JqZWN0VVJMKGZpbGUpOw0KICAgIG9wZW5CdG4uZGlzYWJsZWQgPSBmYWxzZTsNCn0pOw0KDQovLyBPcGVuIGZpbGUgaW4gbmV3IHRhYg0Kb3BlbkJ0bi5hZGRFdmVudExpc3RlbmVyKCdjbGljaycsIGZ1bmN0aW9uICgpIHsNCiAgICBpZiAoIWZpbGVCbG9iVXJsKSByZXR1cm47DQoNCiAgICBjb25zdCBuZXdUYWIgPSB3aW5kb3cub3BlbihmaWxlQmxvYlVybCwgJ19ibGFuaycpOw0KICAgIGlmICghbmV3VGFiKSB7DQogICAgICAgIGFsZXJ0KCdQb3B1cCBibG9ja2VkISBQbGVhc2UgYWxsb3cgcG9wdXBzIGZvciB0aGlzIHNpdGUuJyk7DQogICAgfQ0KfSk7DQo8L3NjcmlwdD4NCg0KPC9ib2R5Pg0KPC9odG1sPg==

Things we won't/can't add

• Nothing that requires a separate TCP/UDP connection (like Simple Voice Chat). Web pages can only communicate with WebSockets, they can't connect to other sockets.
• Java .jar mods - we can't load .jar files dynamically because that requires a full JVM to be built in and a modloader.
• Obvious hacks