SugarPhone is a phone UI, API, and widget set for live text conversations in Twine SugarCube v2.36+. Current Version: 1.0.

The download (SugarPhone.zip) includes the demo + documentation (one file, also playable on this page) plus a template project and install code.

This system intended to be usable by novice developers with minimal HTML, CSS, and JavaScript experience, but it is a difficult place for complete beginners to start.  Use is discouraged if you have never completed a SugarCube2 game or installed third-party macros/styles before.

The SugarPhone documentation follows a similar style and format to the official SugarCube2 documentation, but SugarPhone is NOT associated with the official development. It is a third-party resource by LC3/Leah Case.

In addition to this playable demo, you can see an older version in action in A Political Marriage.

Currently there are no plans for additional features, but updates may be made to the documentation or code for bugs and other issues.

Cover art by Sunny Evans: carrd; itch; twitter; website.

StatusReleased
CategoryTool
PlatformsHTML5
Rating
Rated 5.0 out of 5 stars
(6 total ratings)
AuthorLC3
GenreInteractive Fiction
Tagsresources, tools, Twine, User Interface (UI)

Download

Download NowName your own price

Click download now to get access to the following files:

SugarPhone.zip 484 kB

Comments

Log in with itch.io to leave a comment.

Hello the project doesn't work properly for me when I import the template into Twine app, the conversations don't appear anywhere and there seems to be some broken gibberish at the bottom of the screen instead. Maybe I am importing it in a wrong way? It seems to be working fine if I just open the template in my web browser.

I can't say for certain what the problem would be without more information. My best suggestion would be to ensure you have at least SugarCube 2.36 installed as it includes features that are essential to the code. I was not able to replicate the issue when importing the template fresh into the browser-based version of Twine.

Would you mind dumbing it down for people who don't understand what you're saying the reason why I'm saying this is because I had taken computer repair for over maybe a year and a half to two years and having really sucking memory does not help any of what I've just read

If you want the easiest possible use of sugarphone, I would suggest starting from the SugarPhone Template file (sugarphone_template.html) included in the download. I'd also recommend looking through the demo file (demo_code_examples.tw) since it has the examples used in the main file.

The most important bits are to use <<addcontact>> to set up a contact, then using <<sendchat>> and <<receivechat>> to add the relevant chat passages to the history.

The chat passages themselves just need to have their text surrounded in the <<send>> and <<receive>> widgets.

If you can get those working (referencing the widget documentation is highly recommended!), it may be easier to get into the fancier bits as they become relevant.