even more lua simulation api functions