-
Notifications
You must be signed in to change notification settings - Fork 30
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #282 from Manuito83/develop
Merge for v3.5.2 release
- Loading branch information
Showing
50 changed files
with
5,316 additions
and
1,224 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,64 +1,117 @@ | ||
|  | ||
| [](https://discord.gg/vyP23kJ) | ||
|
|
||
| # TORN PDA | ||
| # TORN PDA | ||
|
|
||
|  | ||
| Torn PDA is an all-in-one assistant developed for players of [TORN City](https://www.torn.com). It aims to make playing Torn on mobile devices more convenient and enjoyable, offering a variety of tools to simplify tasks and enhance your experience. | ||
|
|
||
| Torn PDA has been developed as an assistant for players of [TORN City](https://www.torn.com). | ||
| Torn PDA was first released in May 2020, and since then it has been evolving to meet the needs of the community. It was originally developed for private use to solve simple issues like forgetting that I had landed already a few minutes ago (which often results in getting mugged), or managing chains without constantly switching apps. The app was later made public to help other players facing similar challenges. | ||
|
|
||
| It was conceived to enhance the experience of playing Torn from a mobile platform, and other already existing applications, such as YATA, have been a great influence. | ||
| It is officially endorsed by the developers of Torn (who also provide financial support for the servers used by the app for some applications), and as of the end of 2024 it is used by more than 40k players. | ||
|
|
||
| * Profile page with shortcuts to you preferred sections, access to basic status data, recent events, cooldowns and net-worth calculation. You can also manually activate notifications so that you don't waste any energy, nerve, or miss any cooldown expiry. | ||
| Torn PDA provides easy access to key game information and offers shortcuts to reduce the time needed for common actions. You can view stats, manage chaining targets, and even call for revives, all within the app. Below is a list of the main features Torn PDA offers to enhance your Torn experience. | ||
|
|
||
| * Check your travel status and configure notifications or alarms just before you arrive. No more forgetting and being mugged abroad. Also, configure the notification shown so that it is safe to use even at work or in other public environments. | ||
| You can see all the pending suggestions or developments on our [GitHub project board](https://github.com/users/Manuito83/projects/1) or join our discussions on [Discord](https://discord.gg/vyP23kJ). | ||
|
|
||
| * Have a look at foreign stocks directly in the Travel section. Filter and sort items at your convenience, including profit based on item capacity. Also, by using the in-app browser, you are contributing by sending stock data automatically to the shared database! | ||
| <br /> | ||
|
|
||
| * User scripts support. | ||
| ## Features | ||
|
|
||
| * YATA mobile interface: new sections (e.g. Awards) that constitute the first official YATA mobile interface. Data comes straight from your YATA account. | ||
| - **Profile Overview**: Access shortcuts to your favorite sections, view basic status data, recent events, cooldowns, and net-worth calculations. Set notifications so you never waste energy, nerve, or miss important cooldowns. | ||
|
|
||
| * Ability to fill max items on arrival to destination, based on current capacity and money available. Then, use the quick home return button in the top bar to make your stay quicker and safer. | ||
| - **Travel Notifications**: Track your travel status with customizable alarms to notify you before arrival. Discreet notifications help you stay safe in public places. | ||
|
|
||
| * Quick crimes option when you visit the crimes section. Just set up your preferred crimes and they'll appear in the top bar. | ||
| - **Foreign Stock Management**: View, filter, and sort foreign stocks, including profit calculations based on item capacity. Contributions via the in-app browser help update the shared stock database. | ||
|
|
||
| * Quick Items: browse to the items section in Torn with the full browser and add your prefer items for a quick access later on. | ||
| - **User Scripts Support**: Customize your experience by adding user scripts. Many scripts compatible with Torn PDA can be found in the forums, and the app already includes some example scripts. | ||
|
|
||
| * Trade calculator with total price calculation for cash, items and shares, plus the ability to copy total figures for a quick trading. If you are a professional trader, you can also synchronize with the Arson Warehouse. | ||
| - **YATA Integration**: Access new sections like Awards through the YATA mobile interface. Data is synced directly from your YATA account, and you can also manage and sync awards and chaining targets. | ||
|
|
||
| * Automatic city items finder in the map. | ||
| - **Auto-Fill Items**: Automatically fill your maximum item capacity upon reaching a destination, considering your available money. Use the quick home return button for a more efficient travel experience. | ||
|
|
||
| * Automatic alerts for travel, energy, nerve, hospitalization, drugs, racing, messages and stocks. | ||
| - **Quick Items Access**: Add items to your quick access list from, making them easy to find later. | ||
|
|
||
| * Torn chat: options to highlight your name or hide the chat completely if you wish. | ||
| - **Trade Calculator**: Calculate the total price for cash, items, and shares, with options for synchronization with the Arson Warehouse and Torn Exchange. | ||
|
|
||
| * Follow your faction's chain live from the app, with instant energy updates. Use the chain watcher feature to avoid surprises. | ||
| - **City Items Finder**: Automatically locate city items on the map for easy retrieval. | ||
|
|
||
| * Create your own target list, adding your own comments and many other details. Import and export your targets to/from YATA. While chaining, automatically skip targets that can't be attacked (hospitalised/jailed or in a different country). Chaining has never been easier. | ||
| - **Automatic Alerts**: Receive alerts for travel, energy, nerve, hospitalization, drugs, racing, messages, stocks, and more. | ||
|
|
||
| * Have a look at your last few attacks, with simple statistics so that you can decide when/who to add to your common chaining targets. | ||
| - **Faction Chain Tracking**: Follow your faction's chain live with instant energy updates and a chain watcher feature to avoid surprises. | ||
|
|
||
| * Export targets as a backup or share them with other players. | ||
| - **Target List Management**: Create and manage target lists with comments and details. Import/export targets to/from YATA, and skip targets that cannot be attacked (e.g., hospitalized or in another country). Torn Attack Central integration also allows finding curated targets effortlessly. | ||
|
|
||
| * When in hospital, send Nuclear Central Hospital a revive request by clicking a button. | ||
| - **Attack Logs**: Review your recent attacks and simple statistics to help you manage your common chaining targets. | ||
|
|
||
| * Create a friends list, with quick access to in-game messaging, trading and other important details. Also, add note to your friends' profiles. Backup functionality included. | ||
| - **Target Backup and Sharing**: Export targets as a backup or share them with other players. | ||
|
|
||
| * Activate alerts for NPC loot. | ||
| - **Revive Requests**: Send a revive request to several reviving providers with one click when hospitalized. | ||
|
|
||
| * Dark mode. | ||
| - **Friends List**: Create a friends list for quick access to messaging, trading, and other in-game activities. Add personal notes to profiles and back up friends' information. | ||
|
|
||
| - **NPC Loot Alerts**: Activate alerts for NPC loot opportunities. Integrated with Loot Rangers. | ||
|
|
||
| - **Dark Mode**: Enjoy a comfortable experience with the dark mode option. | ||
|
|
||
| ## iOS / Android | ||
| - **Home Screen Widget**: Available for Android. | ||
|
|
||
| [](https://play.google.com/store/apps/details?id=com.manuito.tornpda "Play Store") | ||
| There are many more features available, but listing them all would be too long. For detailed information on how to use everything, check out the Tips section in the app. You can also review the changelog at [GitHub releases](https://github.com/Manuito83/torn-pda/releases). | ||
|
|
||
| <br /> | ||
|
|
||
| ## Download | ||
|
|
||
| [](https://play.google.com/store/apps/details?id=com.manuito.tornpda "Play Store") | ||
| [](https://apps.apple.com/us/app/torn-pda/id1510138514 "App Store") | ||
|
|
||
| <br /> | ||
|
|
||
| ## Contribute | ||
|
|
||
| Please feel free to contribute by starting a pull request or raising an issue! | ||
| We welcome contributions at different levels! | ||
|
|
||
| - **Developers**: Since Torn PDA is an open-source project, we invite developers to contribute. Join us on [Discord](https://discord.gg/vyP23kJ) to discuss how you can help. The app is open source, but you might need some assistance to set it up the first time, and we're here to guide you. Feel free to raise issues and/or fork the app, work with it and submit a PR if you have a suggestion. | ||
|
|
||
| - **Beta Testers**: If you think you can dedicate enough time, consider joining our beta testing program. Your feedback is invaluable in ensuring the app continues to improve and meet players' needs. You can do so in our Discord server. | ||
|
|
||
| - **General Support**: No matter your skills, you can still support us by giving a thumbs up in the Torn forums and participating in discussions on [Discord](https://discord.gg/vyP23kJ). | ||
|
|
||
| <br /> | ||
|
|
||
| ## Development Team and Partners | ||
|
|
||
| ### Lead Developers | ||
|
|
||
| - [**Manuito**](https://www.torn.com/profiles.php?XID=2225097): Lead developer and founder of Torn PDA | ||
| - [**Kwack**](https://www.torn.com/profiles.php?XID=2190604): Developer, key contributor to app functionalities | ||
|
|
||
| ### Contributors | ||
|
|
||
| - **Phillip_J_Fry**: Discord management and user support | ||
| - **VioletStorm**: Support on Discord and user engagement | ||
| - **Kivou**: Resources and support from YATA | ||
| - **Lazerpent**: Loot Rangers | ||
| - **IceBlueFire**: Contributions through Torn Stats | ||
| - **Mavri**: Torn Spies Central | ||
| - **Knoxby**: Developer of the JavaScript API for cross-origin HTTP requests used in userscripts | ||
|
|
||
| ### Partners | ||
|
|
||
| Thank you to our partners who have chosen Torn PDA as their mobile interface: | ||
|
|
||
| - **YATA** | ||
| - **Arson Warehouse** | ||
| - **Torn Exchange** | ||
| - **Prometheus** | ||
| - **Loot Rangers** | ||
| - **Reviving Providers**: Nuke, UHC, HeLa, WTF, Midnight X, and others | ||
|
|
||
| Additionally, some scripts, concepts, and features have been adapted from pre-existing tools like **YATA**, **Torn Tools**, or **DocTorn**. | ||
|
|
||
| <br /> | ||
|
|
||
| ## Limitations | ||
|
|
||
| - **API Key Requirement**: To use Torn PDA, you must have a Limited API Key from Torn City. | ||
| - **Google Cloud Access**: The app requires access to Google Cloud services, which may be restricted in certain countries or for some users. Please ensure your device has proper access to these services. | ||
| - **System Requirements**: Torn PDA requires at least iOS 12 or Android 6 to function properly. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.