How to use MindJolt’s API (and why you should do it)

Reading the comments in this blog, I saw there is a bit of confusion about MindJolt (MJ from now on) API

MindJolt

On the site, there isn’t any guide, and the only way to have some information is by email from Richard Fields.

Besides Richard must be a very busy guy with such a game portal, he always replies to emails… the only issue is sometimes it may take a week before a mail and another. That’s normal, and I’ll never thank Richard enough for the precious time he spends answering to my emails.

Before I show you how to use MJ API, I would like to tell you why you should use it in your games.

In order to make money with MochiAds, you need to submit a game to portals and sites with three main parameters: games played, eCPM and aggressivity

games played is the amount of times your game will be played in a portal. It’s very important, because sometimes (you will understand later why I wrote “sometimes”) tons of plays mean tons of ads shown and tons of money. Moreover, the more people play your game, the more people may click on the button in your game that opens your site. That’s why sponsors want to have their logo in your game: if your game will be played a lot, it’s possible that a lot of people will click on the “play more games” button they want you to put in your game.
In my case, I can’t say how many people come to this blog from a link into my games, but with about 4,000,000 games played, I think at least 2,000 people come and see this site.
Maybe you are one of them. If I am right, I would like to know it. Having a game on MJ frontpage means having from 30,000 to 50,000 games played every day, even if there was a day Christmas Couples reached 100,000 plays

eCPM is the estimated Cost per mille, or cost per thousand. Anyway in our case it’s not a cost, but the income.
If your game has an eCPM of $0.50, that means that every 1,000 ads shown you will earn 50 cents. eCPM may vary slighty according to the geographical location your game is being played… MochiAds did not release an official table but seems that US players raise the eCPM. My eCPM ranged from $0.02 to about $0.80… that’s 40 times higher, and means that in the first case 40,000 ads generate the same income as 1,000 in the second one.
Since every portal has its own audience, it’s not wrong talking about portals eCPM instead of games eCPM. According to my statistics, I suppose freeworldgroup has a low eCPM while MJ has an high one. It would be nice if someday Mochi guys will release a table with major sites eCPM.

aggressivity maesures the portal as if it was a virus. The more aggressive the virus, the more portals will be infected by your game. You have to know there are some portals that are extremely aggressive: when Circle Chain got a review on Jay is Games, a lot of minor portals got infected by it. Obviously I am not talking about a real infection… but if your game gets a frontpage on some famous portals, then every respectable portal must have your game.
Get a frontpage on NewGrounds, and you won’t need to submit your game to a thousand sites. It would be nice if developers help me to make a list of the most aggressive portals. MJ is not one of them, but it’s a gold mine anyway.

End of the boring part, and let’s see how to use MJ API

In the first frame of your game, the one where probably you put your MochiBot code, add this line:

_lockroot=true;

Then, in the frame where it’s game over and you are about to display the score, just write

ScoreAPI = new LocalConnection();

to connect with MJ server, and

ScoreAPI.send(_root.com_mindjolt_api, "submitScore", yourscorevariable);

To send the score. Just replace yourscorevariable with the variable you used to store the score.

If your game has different modes, such as easy, medium, hard, or puzzle, campaign, and so on, just add an extra variable in this way

ScoreAPI.send(_root.com_mindjolt_api, "submitScore", yourscorevariable, "easy");

Replacing easy with anything you want (just assure this makes a sense)

If your game already hosts MochiAds leaderboards it’s not a problem… there is no conflict and you don’t have to worry about anything. Once your game is ready, you can submit it by email at rfields [at] mindjolt [dot] com and if Richard likes your game, you are about to make at least $20/day

Thanks to Richard Fields for letting me publish this guide (I guess)

Get the most popular Phaser 3 book

Through 202 pages, 32 source code examples and an Android Studio project you will learn how to build cross platform HTML5 games and create a complete game along the way.

Get the book

215 GAME PROTOTYPES EXPLAINED WITH SOURCE CODE
// 1+2=3
// 100 rounds
// 10000000
// 2 Cars
// 2048
// A Blocky Christmas
// A Jumping Block
// A Life of Logic
// Angry Birds
// Angry Birds Space
// Artillery
// Astro-PANIC!
// Avoider
// Back to Square One
// Ball Game
// Ball vs Ball
// Ball: Revamped
// Balloon Invasion
// BallPusher
// Ballz
// Bar Balance
// Bejeweled
// Biggification
// Block it
// Blockage
// Bloons
// Boids
// Bombuzal
// Boom Dots
// Bouncing Ball
// Bouncing Ball 2
// Bouncy Light
// BoxHead
// Breakout
// Bricks
// Bubble Chaos
// Bubbles 2
// Card Game
// Castle Ramble
// Chronotron
// Circle Chain
// Circle Path
// Circle Race
// Circular endless runner
// Cirplosion
// CLOCKS - The Game
// Color Hit
// Color Jump
// ColorFill
// Columns
// Concentration
// Crossy Road
// Crush the Castle
// Cube Jump
// CubesOut
// Dash N Blast
// Dashy Panda
// Deflection
// Diamond Digger Saga
// Don't touch the spikes
// Dots
// Down The Mountain
// Drag and Match
// Draw Game
// Drop Wizard
// DROP'd
// Dudeski
// Dungeon Raid
// Educational Game
// Elasticity
// Endless Runner
// Erase Box
// Eskiv
// Farm Heroes Saga
// Filler
// Flappy Bird
// Fling
// Flipping Legend
// Floaty Light
// Fuse Ballz
// GearTaker
// Gem Sweeper
// Globe
// Goat Rider
// Gold Miner
// Grindstone
// GuessNext
// Helicopter
// Hero Emblems
// Hero Slide
// Hexagonal Tiles
// HookPod
// Hop Hop Hop Underwater
// Horizontal Endless Runner
// Hundreds
// Hungry Hero
// Hurry it's Christmas
// InkTd
// Iromeku
// Jet Set Willy
// Jigsaw Game
// Knife Hit
// Knightfall
// Legends of Runeterra
// Lep's World
// Line Rider
// Lumines
// Magick
// MagOrMin
// Mass Attack
// Math Game
// Maze
// Meeblings
// Memdot
// Metro Siberia Underground
// Mike Dangers
// Mikey Hooks
// Nano War
// Nodes
// o:anquan
// One Button Game
// One Tap RPG
// Ononmin
// Pacco
// Perfect Square!
// Perfectionism
// Phyballs
// Pixel Purge
// PixelField
// Planet Revenge
// Plants Vs Zombies
// Platform
// Platform game
// Plus+Plus
// Pocket Snap
// Poker
// Pool
// Pop the Lock
// Pop to Save
// Poux
// Pudi
// Pumpkin Story
// Puppet Bird
// Pyramids of Ra
// qomp
// Quick Switch
// Racing
// Radical
// Rebuild Chile
// Renju
// Rise Above
// Risky Road
// Roguelike
// Roly Poly
// Run Around
// Rush Hour
// SameGame
// SamePhysics
// Save the Totem
// Security
// Serious Scramblers
// Shrink it
// Sling
// Slingy
// Snowflakes
// Sokoban
// Space Checkers
// Space is Key
// Spellfall
// Spinny Gun
// Splitter
// Spring Ninja
// Sproing
// Stabilize!
// Stack
// Stairs
// Stick Hero
// String Avoider
// Stringy
// Sudoku
// Super Mario Bros
// Surfingers
// Survival Horror
// Talesworth Adventure
// Tetris
// The Impossible Line
// The Moops - Combos of Joy
// The Next Arrow
// Threes
// Tic Tac Toe
// Timberman
// Tiny Wings
// Tipsy Tower
// Toony
// Totem Destroyer
// Tower Defense
// Trick Shot
// Tunnelball
// Turn
// Turnellio
// TwinSpin
// vvvvvv
// Warp Shift
// Way of an Idea
// Whack a Creep
// Wheel of Fortune
// Where's my Water
// Wish Upon a Star
// Word Game
// Wordle
// Worms
// Yanga
// Yeah Bunny
// Zhed
// zNumbers